From 2134ae6792579ca076efb0b4fe34b2aaf5b4ee69 Mon Sep 17 00:00:00 2001 From: Manuel Ebert Date: Tue, 5 Nov 2013 11:54:11 -0800 Subject: [PATCH] Updated docs from master --- Makefile | 15 + docs/Makefile | 177 + docs/_build/doctrees/advanced.doctree | Bin 0 -> 31013 bytes docs/_build/doctrees/encryption.doctree | Bin 0 -> 9975 bytes docs/_build/doctrees/environment.pickle | Bin 0 -> 17384 bytes docs/_build/doctrees/export.doctree | Bin 0 -> 10756 bytes docs/_build/doctrees/index.doctree | Bin 0 -> 3691 bytes docs/_build/doctrees/installation.doctree | Bin 0 -> 10610 bytes docs/_build/doctrees/overview.doctree | Bin 0 -> 7958 bytes docs/_build/doctrees/recipes.doctree | Bin 0 -> 10818 bytes docs/_build/doctrees/usage.doctree | Bin 0 -> 19476 bytes docs/_build/html/.buildinfo | 4 + docs/_build/html/_sources/advanced.txt | 100 + docs/_build/html/_sources/encryption.txt | 39 + docs/_build/html/_sources/export.txt | 67 + docs/_build/html/_sources/index.txt | 20 + docs/_build/html/_sources/installation.txt | 41 + docs/_build/html/_sources/overview.txt | 19 + docs/_build/html/_sources/recipes.txt | 31 + docs/_build/html/_sources/usage.txt | 84 + docs/_build/html/_static/ajax-loader.gif | Bin 0 -> 673 bytes docs/_build/html/_static/basic.css | 540 +++ docs/_build/html/_static/comment-bright.png | Bin 0 -> 3500 bytes docs/_build/html/_static/comment-close.png | Bin 0 -> 3578 bytes docs/_build/html/_static/comment.png | Bin 0 -> 3445 bytes docs/_build/html/_static/css/jrnl.css | 1 + docs/_build/html/_static/doctools.js | 247 ++ docs/_build/html/_static/down-pressed.png | Bin 0 -> 368 bytes docs/_build/html/_static/down.png | Bin 0 -> 363 bytes docs/_build/html/_static/file.png | Bin 0 -> 392 bytes docs/_build/html/_static/img/favicon-152.png | Bin 0 -> 3261 bytes docs/_build/html/_static/img/favicon.ico | Bin 0 -> 5558 bytes docs/_build/html/_static/img/icons.png | Bin 0 -> 10460 bytes docs/_build/html/_static/img/icons@2x.png | Bin 0 -> 21723 bytes docs/_build/html/_static/img/logo.png | Bin 0 -> 2783 bytes docs/_build/html/_static/img/logo@2x.png | Bin 0 -> 5598 bytes docs/_build/html/_static/img/terminal.png | Bin 0 -> 687 bytes docs/_build/html/_static/img/twitter.png | Bin 0 -> 1550 bytes docs/_build/html/_static/jquery.js | 154 + docs/_build/html/_static/js/landing.js | 92 + docs/_build/html/_static/landing.svg | 3558 ++++++++++++++++++ docs/_build/html/_static/less/3L.less | 1369 +++++++ docs/_build/html/_static/less/docs.less | 287 ++ docs/_build/html/_static/less/jrnl.less | 317 ++ docs/_build/html/_static/less/retina.less | 35 + docs/_build/html/_static/minus.png | Bin 0 -> 199 bytes docs/_build/html/_static/plus.png | Bin 0 -> 199 bytes docs/_build/html/_static/pygments.css | 70 + docs/_build/html/_static/searchtools.js | 560 +++ docs/_build/html/_static/sprites.svg | 96 + docs/_build/html/_static/underscore.js | 23 + docs/_build/html/_static/up-pressed.png | Bin 0 -> 372 bytes docs/_build/html/_static/up.png | Bin 0 -> 363 bytes docs/_build/html/_static/websupport.js | 808 ++++ docs/_build/html/advanced.html | 203 + docs/_build/html/encryption.html | 119 + docs/_build/html/export.html | 142 + docs/_build/html/genindex.html | 88 + docs/_build/html/index.html | 95 + docs/_build/html/installation.html | 115 + docs/_build/html/objects.inv | 9 + docs/_build/html/overview.html | 99 + docs/_build/html/recipes.html | 116 + docs/_build/html/search.html | 95 + docs/_build/html/searchindex.js | 1 + docs/_build/html/usage.html | 160 + docs/_themes/jrnl/index.html | 93 + docs/_themes/jrnl/layout.html | 29 + docs/_themes/jrnl/relations.html | 19 + docs/_themes/jrnl/static/css/jrnl.css | 1 + docs/_themes/jrnl/static/img/favicon-152.png | Bin 0 -> 3261 bytes docs/_themes/jrnl/static/img/favicon.ico | Bin 0 -> 5558 bytes docs/_themes/jrnl/static/img/icons.png | Bin 0 -> 10460 bytes docs/_themes/jrnl/static/img/icons@2x.png | Bin 0 -> 21723 bytes docs/_themes/jrnl/static/img/logo.png | Bin 0 -> 2783 bytes docs/_themes/jrnl/static/img/logo@2x.png | Bin 0 -> 5598 bytes docs/_themes/jrnl/static/img/terminal.png | Bin 0 -> 687 bytes docs/_themes/jrnl/static/img/twitter.png | Bin 0 -> 1550 bytes docs/_themes/jrnl/static/js/landing.js | 92 + docs/_themes/jrnl/static/landing.svg | 3558 ++++++++++++++++++ docs/_themes/jrnl/static/less/3L.less | 1369 +++++++ docs/_themes/jrnl/static/less/docs.less | 287 ++ docs/_themes/jrnl/static/less/jrnl.less | 317 ++ docs/_themes/jrnl/static/less/retina.less | 35 + docs/_themes/jrnl/static/sprites.svg | 96 + docs/_themes/jrnl/theme.conf | 7 + docs/advanced.rst | 100 + docs/conf.py | 254 ++ docs/encryption.rst | 39 + docs/export.rst | 67 + docs/index.rst | 20 + docs/installation.rst | 41 + docs/overview.rst | 19 + docs/recipes.rst | 31 + docs/usage.rst | 84 + gh_pages.py | 68 + jrnl/Entry.py | 92 + jrnl/Entry.pyc | Bin 0 -> 3864 bytes jrnl/Journal.py | 366 ++ jrnl/Journal.pyc | Bin 0 -> 13843 bytes jrnl/__init__.py | 17 + jrnl/__init__.pyc | Bin 0 -> 537 bytes jrnl/exporters.py | 110 + jrnl/exporters.pyc | Bin 0 -> 5040 bytes jrnl/install.py | 96 + jrnl/install.pyc | Bin 0 -> 3902 bytes jrnl/jrnl.py | 223 ++ jrnl/jrnl.pyc | Bin 0 -> 9065 bytes jrnl/util.py | 119 + jrnl/util.pyc | Bin 0 -> 4864 bytes 110 files changed, 17645 insertions(+) create mode 100644 Makefile create mode 100644 docs/Makefile create mode 100644 docs/_build/doctrees/advanced.doctree create mode 100644 docs/_build/doctrees/encryption.doctree create mode 100644 docs/_build/doctrees/environment.pickle create mode 100644 docs/_build/doctrees/export.doctree create mode 100644 docs/_build/doctrees/index.doctree create mode 100644 docs/_build/doctrees/installation.doctree create mode 100644 docs/_build/doctrees/overview.doctree create mode 100644 docs/_build/doctrees/recipes.doctree create mode 100644 docs/_build/doctrees/usage.doctree create mode 100644 docs/_build/html/.buildinfo create mode 100644 docs/_build/html/_sources/advanced.txt create mode 100644 docs/_build/html/_sources/encryption.txt create mode 100644 docs/_build/html/_sources/export.txt create mode 100644 docs/_build/html/_sources/index.txt create mode 100644 docs/_build/html/_sources/installation.txt create mode 100644 docs/_build/html/_sources/overview.txt create mode 100644 docs/_build/html/_sources/recipes.txt create mode 100644 docs/_build/html/_sources/usage.txt create mode 100644 docs/_build/html/_static/ajax-loader.gif create mode 100644 docs/_build/html/_static/basic.css create mode 100644 docs/_build/html/_static/comment-bright.png create mode 100644 docs/_build/html/_static/comment-close.png create mode 100644 docs/_build/html/_static/comment.png create mode 100644 docs/_build/html/_static/css/jrnl.css create mode 100644 docs/_build/html/_static/doctools.js create mode 100644 docs/_build/html/_static/down-pressed.png create mode 100644 docs/_build/html/_static/down.png create mode 100644 docs/_build/html/_static/file.png create mode 100644 docs/_build/html/_static/img/favicon-152.png create mode 100644 docs/_build/html/_static/img/favicon.ico create mode 100644 docs/_build/html/_static/img/icons.png create mode 100644 docs/_build/html/_static/img/icons@2x.png create mode 100644 docs/_build/html/_static/img/logo.png create mode 100644 docs/_build/html/_static/img/logo@2x.png create mode 100644 docs/_build/html/_static/img/terminal.png create mode 100644 docs/_build/html/_static/img/twitter.png create mode 100644 docs/_build/html/_static/jquery.js create mode 100644 docs/_build/html/_static/js/landing.js create mode 100644 docs/_build/html/_static/landing.svg create mode 100644 docs/_build/html/_static/less/3L.less create mode 100644 docs/_build/html/_static/less/docs.less create mode 100644 docs/_build/html/_static/less/jrnl.less create mode 100644 docs/_build/html/_static/less/retina.less create mode 100644 docs/_build/html/_static/minus.png create mode 100644 docs/_build/html/_static/plus.png create mode 100644 docs/_build/html/_static/pygments.css create mode 100644 docs/_build/html/_static/searchtools.js create mode 100644 docs/_build/html/_static/sprites.svg create mode 100644 docs/_build/html/_static/underscore.js create mode 100644 docs/_build/html/_static/up-pressed.png create mode 100644 docs/_build/html/_static/up.png create mode 100644 docs/_build/html/_static/websupport.js create mode 100644 docs/_build/html/advanced.html create mode 100644 docs/_build/html/encryption.html create mode 100644 docs/_build/html/export.html create mode 100644 docs/_build/html/genindex.html create mode 100644 docs/_build/html/index.html create mode 100644 docs/_build/html/installation.html create mode 100644 docs/_build/html/objects.inv create mode 100644 docs/_build/html/overview.html create mode 100644 docs/_build/html/recipes.html create mode 100644 docs/_build/html/search.html create mode 100644 docs/_build/html/searchindex.js create mode 100644 docs/_build/html/usage.html create mode 100755 docs/_themes/jrnl/index.html create mode 100755 docs/_themes/jrnl/layout.html create mode 100755 docs/_themes/jrnl/relations.html create mode 100644 docs/_themes/jrnl/static/css/jrnl.css create mode 100644 docs/_themes/jrnl/static/img/favicon-152.png create mode 100644 docs/_themes/jrnl/static/img/favicon.ico create mode 100644 docs/_themes/jrnl/static/img/icons.png create mode 100644 docs/_themes/jrnl/static/img/icons@2x.png create mode 100644 docs/_themes/jrnl/static/img/logo.png create mode 100644 docs/_themes/jrnl/static/img/logo@2x.png create mode 100644 docs/_themes/jrnl/static/img/terminal.png create mode 100644 docs/_themes/jrnl/static/img/twitter.png create mode 100644 docs/_themes/jrnl/static/js/landing.js create mode 100644 docs/_themes/jrnl/static/landing.svg create mode 100644 docs/_themes/jrnl/static/less/3L.less create mode 100644 docs/_themes/jrnl/static/less/docs.less create mode 100644 docs/_themes/jrnl/static/less/jrnl.less create mode 100644 docs/_themes/jrnl/static/less/retina.less create mode 100755 docs/_themes/jrnl/static/sprites.svg create mode 100755 docs/_themes/jrnl/theme.conf create mode 100644 docs/advanced.rst create mode 100644 docs/conf.py create mode 100644 docs/encryption.rst create mode 100644 docs/export.rst create mode 100644 docs/index.rst create mode 100644 docs/installation.rst create mode 100644 docs/overview.rst create mode 100644 docs/recipes.rst create mode 100644 docs/usage.rst create mode 100644 gh_pages.py create mode 100644 jrnl/Entry.py create mode 100644 jrnl/Entry.pyc create mode 100644 jrnl/Journal.py create mode 100644 jrnl/Journal.pyc create mode 100644 jrnl/__init__.py create mode 100644 jrnl/__init__.pyc create mode 100644 jrnl/exporters.py create mode 100644 jrnl/exporters.pyc create mode 100644 jrnl/install.py create mode 100644 jrnl/install.pyc create mode 100755 jrnl/jrnl.py create mode 100644 jrnl/jrnl.pyc create mode 100644 jrnl/util.py create mode 100644 jrnl/util.pyc diff --git a/Makefile b/Makefile new file mode 100644 index 00000000..dd62b134 --- /dev/null +++ b/Makefile @@ -0,0 +1,15 @@ +# This currently only builds gh-pages from docs + +gh_pages: + git checkout gh-pages ; \ + git checkout master docs ; \ + git checkout master jrnl ; \ + cd docs ; \ + make html ; \ + cd .. ; \ + cp -r docs/_build/html/* . ; \ + git add * ; \ + git commit -m "Updated docs from master" ; \ + git push -u origin gh-pages ; \ + git checkout master + diff --git a/docs/Makefile b/docs/Makefile new file mode 100644 index 00000000..43b60517 --- /dev/null +++ b/docs/Makefile @@ -0,0 +1,177 @@ +# Makefile for Sphinx documentation +# + +# You can set these variables from the command line. +SPHINXOPTS = +SPHINXBUILD = sphinx-build +PAPER = +BUILDDIR = _build + +# User-friendly check for sphinx-build +ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1) +$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/) +endif + +# Internal variables. +PAPEROPT_a4 = -D latex_paper_size=a4 +PAPEROPT_letter = -D latex_paper_size=letter +ALLSPHINXOPTS = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . +# the i18n builder cannot share the environment and doctrees with the others +I18NSPHINXOPTS = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) . + +.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext + +help: + @echo "Please use \`make ' where is one of" + @echo " html to make standalone HTML files" + @echo " dirhtml to make HTML files named index.html in directories" + @echo " singlehtml to make a single large HTML file" + @echo " pickle to make pickle files" + @echo " json to make JSON files" + @echo " htmlhelp to make HTML files and a HTML help project" + @echo " qthelp to make HTML files and a qthelp project" + @echo " devhelp to make HTML files and a Devhelp project" + @echo " epub to make an epub" + @echo " latex to make LaTeX files, you can set PAPER=a4 or PAPER=letter" + @echo " latexpdf to make LaTeX files and run them through pdflatex" + @echo " latexpdfja to make LaTeX files and run them through platex/dvipdfmx" + @echo " text to make text files" + @echo " man to make manual pages" + @echo " texinfo to make Texinfo files" + @echo " info to make Texinfo files and run them through makeinfo" + @echo " gettext to make PO message catalogs" + @echo " changes to make an overview of all changed/added/deprecated items" + @echo " xml to make Docutils-native XML files" + @echo " pseudoxml to make pseudoxml-XML files for display purposes" + @echo " linkcheck to check all external links for integrity" + @echo " doctest to run all doctests embedded in the documentation (if enabled)" + +clean: + rm -rf $(BUILDDIR)/* + +html: + $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html + @echo + @echo "Build finished. The HTML pages are in $(BUILDDIR)/html." + +dirhtml: + $(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml + @echo + @echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml." + +singlehtml: + $(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml + @echo + @echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml." + +pickle: + $(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle + @echo + @echo "Build finished; now you can process the pickle files." + +json: + $(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json + @echo + @echo "Build finished; now you can process the JSON files." + +htmlhelp: + $(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp + @echo + @echo "Build finished; now you can run HTML Help Workshop with the" \ + ".hhp project file in $(BUILDDIR)/htmlhelp." + +qthelp: + $(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp + @echo + @echo "Build finished; now you can run "qcollectiongenerator" with the" \ + ".qhcp project file in $(BUILDDIR)/qthelp, like this:" + @echo "# qcollectiongenerator $(BUILDDIR)/qthelp/jrnl.qhcp" + @echo "To view the help file:" + @echo "# assistant -collectionFile $(BUILDDIR)/qthelp/jrnl.qhc" + +devhelp: + $(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp + @echo + @echo "Build finished." + @echo "To view the help file:" + @echo "# mkdir -p $$HOME/.local/share/devhelp/jrnl" + @echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/jrnl" + @echo "# devhelp" + +epub: + $(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub + @echo + @echo "Build finished. The epub file is in $(BUILDDIR)/epub." + +latex: + $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + @echo + @echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex." + @echo "Run \`make' in that directory to run these through (pdf)latex" \ + "(use \`make latexpdf' here to do that automatically)." + +latexpdf: + $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + @echo "Running LaTeX files through pdflatex..." + $(MAKE) -C $(BUILDDIR)/latex all-pdf + @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." + +latexpdfja: + $(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex + @echo "Running LaTeX files through platex and dvipdfmx..." + $(MAKE) -C $(BUILDDIR)/latex all-pdf-ja + @echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex." + +text: + $(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text + @echo + @echo "Build finished. The text files are in $(BUILDDIR)/text." + +man: + $(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man + @echo + @echo "Build finished. The manual pages are in $(BUILDDIR)/man." + +texinfo: + $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo + @echo + @echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo." + @echo "Run \`make' in that directory to run these through makeinfo" \ + "(use \`make info' here to do that automatically)." + +info: + $(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo + @echo "Running Texinfo files through makeinfo..." + make -C $(BUILDDIR)/texinfo info + @echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo." + +gettext: + $(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale + @echo + @echo "Build finished. The message catalogs are in $(BUILDDIR)/locale." + +changes: + $(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes + @echo + @echo "The overview file is in $(BUILDDIR)/changes." + +linkcheck: + $(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck + @echo + @echo "Link check complete; look for any errors in the above output " \ + "or in $(BUILDDIR)/linkcheck/output.txt." + +doctest: + $(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest + @echo "Testing of doctests in the sources finished, look at the " \ + "results in $(BUILDDIR)/doctest/output.txt." + +xml: + $(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml + @echo + @echo "Build finished. The XML files are in $(BUILDDIR)/xml." + +pseudoxml: + $(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml + @echo + @echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml." diff --git a/docs/_build/doctrees/advanced.doctree b/docs/_build/doctrees/advanced.doctree new file mode 100644 index 0000000000000000000000000000000000000000..60d68fe15a1a712acb7d5f1438557a5ab53a45bd GIT binary patch literal 31013 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 literal 0 HcmV?d00001 diff --git a/docs/_build/doctrees/encryption.doctree b/docs/_build/doctrees/encryption.doctree new file mode 100644 index 0000000000000000000000000000000000000000..1e3bc64a6323948971ae8b53673c75e559a16020 GIT binary patch literal 9975 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 literal 0 HcmV?d00001 diff --git a/docs/_build/doctrees/installation.doctree b/docs/_build/doctrees/installation.doctree new file mode 100644 index 0000000000000000000000000000000000000000..b035ef666ed9ba408825d3359e57b7f4d991c3b2 GIT binary patch literal 10610 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 literal 0 HcmV?d00001 diff --git a/docs/_build/doctrees/overview.doctree b/docs/_build/doctrees/overview.doctree new file mode 100644 index 0000000000000000000000000000000000000000..296d28d163d515a99b643b87ddd1990ae82bfb3e GIT binary patch literal 7958 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 j=qoU_rmw`WZG@pb(O2Om(^unHP1p1_{2w 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 Zd5_lMM?h=w*I7SC>-dR-VYTeQ{{mDT?U(=n literal 0 HcmV?d00001 diff --git a/docs/_build/html/.buildinfo b/docs/_build/html/.buildinfo new file mode 100644 index 00000000..cfbaeae9 --- /dev/null +++ b/docs/_build/html/.buildinfo @@ -0,0 +1,4 @@ +# Sphinx build info version 1 +# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. +config: a9599248d4284f4705aed48637544b87 +tags: fbb0d17656682115ca4d033fb2f83ba1 diff --git a/docs/_build/html/_sources/advanced.txt b/docs/_build/html/_sources/advanced.txt new file mode 100644 index 00000000..10c204b7 --- /dev/null +++ b/docs/_build/html/_sources/advanced.txt @@ -0,0 +1,100 @@ +.. _advanced: + +Advanced Usage +============== + +Configuration File +------------------- + +The configuration file is a simple JSON file with the following options. + +- ``journals`` + paths to your journal files +- ``editor`` + if set, executes this command to launch an external editor for writing your entries, e.g. ``vim`` or ``subl -w`` (note the ``-w`` flag to make sure _jrnl_ waits for Sublime Text to close the file before writing into the journal. If you're using MacVim, that would be ``mvim -f``). +- ``encrypt`` + if ``true``, encrypts your journal using AES. +- ``tagsymbols`` + Symbols to be interpreted as tags. (__See note below__) +- ``default_hour`` and ``default_minute`` + if you supply a date, such as ``last thursday``, but no specific time, the entry will be created at this time +- ``timeformat`` + how to format the timestamps in your journal, see the [python docs](http://docs.python.org/library/time.html#time.strftime) for reference +- ``highlight`` + if ``true``, tags will be highlighted in cyan. +- ``linewrap`` + controls the width of the output. Set to ``false`` if you don't want to wrap long lines. + +.. note:: + + Although it seems intuitive to use the `#` character for tags, there's a drawback: on most shells, this is interpreted as a meta-character starting a comment. This means that if you type + + .. code-block:: note + + jrnl Implemented endless scrolling on the #frontend of our website. + + your bash will chop off everything after the ``#`` before passing it to _jrnl_). To avoid this, wrap your input into quotation marks like this: + + .. code-block:: note + + jrnl "Implemented endless scrolling on the #frontend of our website." + + Or use the built-in prompt or an external editor to compose your entries. + +DayOne Integration +------------------ + +Using your DayOne journal instead of a flat text file is dead simple - instead of pointing to a text file, change your `.jrnl_conf` to point to your DayOne journal. This is a folder ending with `.dayone`, and it's located at + +* ``~/Library/Application Support/Day One/`` by default +* ``~/Dropbox/Apps/Day One/`` if you're syncing with Dropbox and +* ``~/Library/Mobile Documents/5U8NS4GX82~com~dayoneapp~dayone/Documents/`` if you're syncing with iCloud. + +Instead of all entries being in a single file, each entry will live in a separate `plist` file. You can also star entries when you write them: + + jrnl -star yesterday: Lunch with @Arthur + +Multiple journal files +---------------------- + +You can configure _jrnl_ to use with multiple journals (eg. ``private`` and ``work``) by defining more journals in your ``.jrnl_config``, for example: + +.. code-block:: javascript + + { + ... + "journals": { + "default": "~/journal.txt", + "work": "~/work.txt" + } + } + +The ``default`` journal gets created the first time you start _jrnl_. Now you can access the ``work`` journal by using ``jrnl work`` instead of ``jrnl``, eg. :: + + jrnl work at 10am: Meeting with @Steve + jrnl work -n 3 + +will both use ``~/work.txt``, while ``jrnl -n 3`` will display the last three entries from ``~/journal.txt`` (and so does ``jrnl default -n 3``). + +You can also override the default options for each individual journal. If you ``.jrnl_conf`` looks like this: + +.. code-block:: javascript + + { + ... + "encrypt": false + "journals": { + "default": "~/journal.txt", + "work": { + "journal": "~/work.txt", + "encrypt": true + }, + "food": "~/my_recipes.txt", + } + +Your ``default`` and your ``food`` journals won't be encrypted, however your ``work`` journal will! You can override all options that are present at the top level of ``.jrnl_conf``, just make sure that at the very least you specify a ``"journal": ...`` key that points to the journal file of that journal. + +.. note:: + + Changing ``encrypt`` to a different value will not encrypt or decrypt your journal file, it merely says whether or not your journal `is` encrypted. Hence manually changing this option will most likely result in your journal file being impossible to load. + diff --git a/docs/_build/html/_sources/encryption.txt b/docs/_build/html/_sources/encryption.txt new file mode 100644 index 00000000..ebb54865 --- /dev/null +++ b/docs/_build/html/_sources/encryption.txt @@ -0,0 +1,39 @@ +.. _encryption: + +Encryption +========== + +Encrypting and decrypting +------------------------- + + +If you don't choose to encrypt your file when you run `jrnl` for the first time, you can encrypt your existing journal file or change its password using :: + + jrnl --encrypt + +If it is already encrypted, you will first be asked for the current password. You can then enter a new password and your plain journal will replaced by the encrypted file. Conversely, :: + + jrnl --decrypt + +will replace your encrypted journal file by a Journal in plain text. You can also specify a filename, ie. `jrnl --decrypt plain_text_copy.txt`, to leave your original file untouched. + + +Storing passwords in your keychain +---------------------------------- + +Whenever you encrypt your journal, you are asked whether you want to store the encryption password in your keychain. If you do this, you won't have to enter your password every time you want to write or read your journal. + +If you don't initially store the password in the keychain but decide to do so at a later point -- or maybe want to store it on one computer but not on another -- you can simply run `jrnl --encrypt` on an encrypted journal and use the same password again. + + +Manual decryption +----------------- + +Should you ever want to decrypt your journal manually, you can do so with any program that supports the AES algorithm. The key used for encryption is the SHA-256-hash of your password, and the IV (initialisation vector) is stored in the first 16 bytes of the encrypted file. So, to decrypt a journal file in python, run:: + + import hashlib, Crypto.Cipher + key = hashlib.sha256(my_password).digest() + with open("my_journal.txt") as f: + cipher = f.read() + crypto = AES.new(key, AES.MODE_CBC, iv = cipher[:16]) + plain = crypto.decrypt(cipher[16:]) diff --git a/docs/_build/html/_sources/export.txt b/docs/_build/html/_sources/export.txt new file mode 100644 index 00000000..4a040b09 --- /dev/null +++ b/docs/_build/html/_sources/export.txt @@ -0,0 +1,67 @@ +.. _export: + +Import and Export +================= + +Tag export +---------- + +With:: + + jrnl --tags + +you'll get a list of all tags you used in your journal, sorted by most frequent. Tags occurring several times in the same entry are only counted as one. + +List of all entries +------------------- + + jrnl --short + +Will only display the date and title of each entry. + +JSON export +----------- + +Can do:: + + jrnl --export json + +Why not create a `beautiful timeline `_ of your journal? + +Markdown export +--------------- + +Use:: + + jrnl --export markdown + +Markdown is a simple markup language that is human readable and can be used to be rendered to other formats (html, pdf). This README for example is formatted in markdown and github makes it look nice. + +Text export +----------- + +:: + + jrnl --export text + +Pretty-prints your entire journal. + +Export to files +--------------- + +You can specify the output file of your exported journal using the `-o` argument:: + + jrnl --export md -o journal.md + +The above command will generate a file named `journal.md`. If the `-o` argument is a directory, jrnl will export each entry into an individual file:: + + jrnl --export json -o my_entries/ + +The contents of `my_entries/` will then look like this: + +.. code-block:: output + + my_entries/ + |- 2013_06_03_a-beautiful-day.json + |- 2013_06_07_dinner-with-gabriel.json + |- ... diff --git a/docs/_build/html/_sources/index.txt b/docs/_build/html/_sources/index.txt new file mode 100644 index 00000000..c7d7119b --- /dev/null +++ b/docs/_build/html/_sources/index.txt @@ -0,0 +1,20 @@ +.. jrnl documentation master file, created by + sphinx-quickstart on Wed Aug 7 13:22:51 2013. + +jrnl: The command-line journal +============================== + +Release v\ |version|. + +Contents: + +.. toctree:: + :maxdepth: 3 + + overview + installation + usage + encryption + export + advanced + recipes diff --git a/docs/_build/html/_sources/installation.txt b/docs/_build/html/_sources/installation.txt new file mode 100644 index 00000000..709eb9c3 --- /dev/null +++ b/docs/_build/html/_sources/installation.txt @@ -0,0 +1,41 @@ +.. _download: + +Getting started +=============== + +Installation +------------ + +Install *jrnl* using pip :: + + pip install jrnl + +Or, if you want the option to encrypt your journal, :: + + pip install jrnl[encrypted] + +to install the dependencies for encrypting journals as well. + +.. note:: + + Installing the encryption library, `pycrypto`, requires a `gcc` compiler. For this reason, jrnl will not install `pycrypto` unless explicitly told so like this. You can `install PyCyrypto manually `_ first or install it with ``pip install pycrypto`` if you have a `gcc` compiler. + +The first time you run ``jrnl`` you will be asked where your journal file should be created and whether you wish to encrypt it. + + +Quickstart +---------- + +to make a new entry, just type:: + + jrnl yesterday: Called in sick. Used the time to clean the house and spent 4h on writing my book. + +and hit return. ``yesterday:`` will be interpreted as a time stamp. Everything until the first sentence mark (``.?!:``) will be interpreted as the title, the rest as the body. In your journal file, the result will look like this: + +.. code-block:: output + + 2012-03-29 09:00 Called in sick. + Used the time to clean the house and spent 4h on writing my book. + +If you just call ``jrnl``, you will be prompted to compose your entry - but you can also configure *jrnl* to use your external editor. + diff --git a/docs/_build/html/_sources/overview.txt b/docs/_build/html/_sources/overview.txt new file mode 100644 index 00000000..532fde36 --- /dev/null +++ b/docs/_build/html/_sources/overview.txt @@ -0,0 +1,19 @@ +.. _overview: + +Overview +=============== + +What is jrnl? +------------- + +`jrnl` is a simple journal application for your command line. Journals are stored as human readable plain text files - you can put them into a Dropbox folder for instant syncing and you can be assured that your journal will still be readable in 2050, when all your fancy iPad journal applications will long be forgotten. + +`jrnl` also plays nice with the fabulous `DayOne `_ and can read and write directly from and to DayOne Journals. + +Optionally, your journal can be encrypted using the `256-bit AES `_. + +Why keep a journal? +------------------- + +Journals aren't only for 13-year old girls and people who have too much time on their summer vacation. A journal helps you to keep track of the things you get done and how you did them. Your imagination may be limitless, but your memory isn't. For personal use, make it a good habit to write at least 20 words a day. Just to reflect what made this day special, why you haven't wasted it. For professional use, consider a text-based journal to be the perfect complement to your GTD todo list - a documentation of what and how you've done it. + diff --git a/docs/_build/html/_sources/recipes.txt b/docs/_build/html/_sources/recipes.txt new file mode 100644 index 00000000..9ae55a86 --- /dev/null +++ b/docs/_build/html/_sources/recipes.txt @@ -0,0 +1,31 @@ +.. _recipes: + +FAQ +=== + +Recipes +------- + +Co-occurrence of tags +~~~~~~~~~~~~~~~~~~~~~ + +If I want to find out how often I mentioned my flatmates Alberto and Melo in the same entry, I run :: + + jrnl @alberto --tags | grep @melo + +And will get something like ``@melo: 9``, meaning there are 9 entries where both ``@alberto`` and ``@melo`` are tagged. How does this work? First, ``jrnl @alberto`` will filter the journal to only entries containing the tag ``@alberto``, and then the ``--tags`` option will print out how often each tag occurred in this `filtered` journal. Finally, we pipe this to ``grep`` which will only display the line containing ``@melo``. + +Combining filters +~~~~~~~~~~~~~~~~~ + +You can do things like :: + + jrnl @fixed -starred -n 10 -until "jan 2013" --short + +To get a short summary of the 10 most recent, favourited entries before January 1, 2013 that are tagged with ``@fixed``. + +Known Issues +------------ + +- The Windows shell prior to Windows 7 has issues with unicode encoding. If you want to use non-ascii characters, change the codepage with ``chcp 1252`` before using `jrnl` (Thanks to Yves Pouplard for solving this!) +- _jrnl_ relies on the `PyCrypto` package to encrypt journals, which has some known problems with installing on Windows and within virtual environments. diff --git a/docs/_build/html/_sources/usage.txt b/docs/_build/html/_sources/usage.txt new file mode 100644 index 00000000..c17bd761 --- /dev/null +++ b/docs/_build/html/_sources/usage.txt @@ -0,0 +1,84 @@ +.. _usage: + +Basic Usage +=========== + +*jrnl* has two modes: **composing** and **viewing**. Basically, whenever you `don't` supply any arguments that start with a dash or double-dash, you're in composing mode, meaning you can write your entry on the command line or an editor of your choice. + +We intentionally break a convention on command line arguments: all arguments starting with a `single dash` will `filter` your journal before viewing it, and can be combined arbitrarily. Arguments with a `double dash` will control how your journal is displayed or exported and are mutually exclusive (ie. you can only specify one way to display or export your journal at a time). + + +Composing Entries +----------------- + +Composing mode is entered by either starting ``jrnl`` without any arguments -- which will prompt you to write an entry or launch your editor -- or by just writing an entry on the prompt, such as:: + + jrnl today at 3am: I just met Steve Buscemi in a bar! He looked funny. + + +Smart timestamps +~~~~~~~~~~~~~~~~ + +Timestamps that work: + +* at 6am +* yesterday +* last monday +* sunday at noon +* 2 march 2012 +* 7 apr +* 5/20/1998 at 23:42 + +Starring entries +~~~~~~~~~~~~~~~~ + +To mark an entry as a favourite, simply "star" it:: + + jrnl last sunday *: Best day of my life. + +If you don't want to add a date (ie. your entry will be dated as now), The following options are equivalent: + +* ``jrnl *: Best day of my life.`` +* ``jrnl *Best day of my life.`` +* ``jrnl Best day of my life.*`` + +.. note:: + + Just make sure that the asterisk sign is **not** surrounded by whitespaces, e.g. ``jrnl Best day of my life! *`` will **not** work (the reason being that the ``*`` sign has a special meaning on most shells). + +Viewing +------- + +:: + + jrnl -n 10 + +will list you the ten latest entries, :: + + jrnl -from "last year" -until march + +everything that happened from the start of last year to the start of last march. To only see your favourite entries, use :: + + jrnl -starred + +Using Tags +---------- + +Keep track of people, projects or locations, by tagging them with an ``@`` in your entries :: + + jrnl Had a wonderful day on the @beach with @Tom and @Anna. + +You can filter your journal entries just like this: :: + + jrnl @pinkie @WorldDomination + +Will print all entries in which either ``@pinkie`` or ``@WorldDomination`` occurred. :: + + jrnl -n 5 -and @pineapple @lubricant + +the last five entries containing both ``@pineapple`` **and** ``@lubricant``. You can change which symbols you'd like to use for tagging in the configuration. + +.. note:: + + ``jrnl @pinkie @WorldDomination`` will switch to viewing mode because although _no_ command line arguments are given, all the input strings look like tags - *jrnl* will assume you want to filter by tag. + diff --git a/docs/_build/html/_static/ajax-loader.gif b/docs/_build/html/_static/ajax-loader.gif new file mode 100644 index 0000000000000000000000000000000000000000..61faf8cab23993bd3e1560bff0668bd628642330 GIT binary patch literal 673 zcmZ?wbhEHb6krfw_{6~Q|Nno%(3)e{?)x>&1u}A`t?OF7Z|1gRivOgXi&7IyQd1Pl zGfOfQ60;I3a`F>X^fL3(@);C=vM_KlFfb_o=k{|A33hf2a5d61U}gjg=>Rd%XaNQW zW@Cw{|b%Y*pl8F?4B9 zlo4Fz*0kZGJabY|>}Okf0}CCg{u4`zEPY^pV?j2@h+|igy0+Kz6p;@SpM4s6)XEMg z#3Y4GX>Hjlml5ftdH$4x0JGdn8~MX(U~_^d!Hi)=HU{V%g+mi8#UGbE-*ao8f#h+S z2a0-5+vc7MU$e-NhmBjLIC1v|)9+Im8x1yacJ7{^tLX(ZhYi^rpmXm0`@ku9b53aN zEXH@Y3JaztblgpxbJt{AtE1ad1Ca>{v$rwwvK(>{m~Gf_=-Ro7Fk{#;i~+{{>QtvI yb2P8Zac~?~=sRA>$6{!(^3;ZP0TPFR(G_-UDU(8Jl0?(IXu$~#4A!880|o%~Al1tN literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/basic.css b/docs/_build/html/_static/basic.css new file mode 100644 index 00000000..43e8bafa --- /dev/null +++ b/docs/_build/html/_static/basic.css @@ -0,0 +1,540 @@ +/* + * basic.css + * ~~~~~~~~~ + * + * Sphinx stylesheet -- basic theme. + * + * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/* -- main layout ----------------------------------------------------------- */ + +div.clearer { + clear: both; +} + +/* -- relbar ---------------------------------------------------------------- */ + +div.related { + width: 100%; + font-size: 90%; +} + +div.related h3 { + display: none; +} + +div.related ul { + margin: 0; + padding: 0 0 0 10px; + list-style: none; +} + +div.related li { + display: inline; +} + +div.related li.right { + float: right; + margin-right: 5px; +} + +/* -- sidebar --------------------------------------------------------------- */ + +div.sphinxsidebarwrapper { + padding: 10px 5px 0 10px; +} + +div.sphinxsidebar { + float: left; + width: 230px; + margin-left: -100%; + font-size: 90%; +} + +div.sphinxsidebar ul { + list-style: none; +} + +div.sphinxsidebar ul ul, +div.sphinxsidebar ul.want-points { + margin-left: 20px; + list-style: square; +} + +div.sphinxsidebar ul ul { + margin-top: 0; + margin-bottom: 0; +} + +div.sphinxsidebar form { + margin-top: 10px; +} + +div.sphinxsidebar input { + border: 1px solid #98dbcc; + font-family: sans-serif; + font-size: 1em; +} + +div.sphinxsidebar #searchbox input[type="text"] { + width: 170px; +} + +div.sphinxsidebar #searchbox input[type="submit"] { + width: 30px; +} + +img { + border: 0; +} + +/* -- search page ----------------------------------------------------------- */ + +ul.search { + margin: 10px 0 0 20px; + padding: 0; +} + +ul.search li { + padding: 5px 0 5px 20px; + background-image: url(file.png); + background-repeat: no-repeat; + background-position: 0 7px; +} + +ul.search li a { + font-weight: bold; +} + +ul.search li div.context { + color: #888; + margin: 2px 0 0 30px; + text-align: left; +} + +ul.keywordmatches li.goodmatch a { + font-weight: bold; +} + +/* -- index page ------------------------------------------------------------ */ + +table.contentstable { + width: 90%; +} + +table.contentstable p.biglink { + line-height: 150%; +} + +a.biglink { + font-size: 1.3em; +} + +span.linkdescr { + font-style: italic; + padding-top: 5px; + font-size: 90%; +} + +/* -- general index --------------------------------------------------------- */ + +table.indextable { + width: 100%; +} + +table.indextable td { + text-align: left; + vertical-align: top; +} + +table.indextable dl, table.indextable dd { + margin-top: 0; + margin-bottom: 0; +} + +table.indextable tr.pcap { + height: 10px; +} + +table.indextable tr.cap { + margin-top: 10px; + background-color: #f2f2f2; +} + +img.toggler { + margin-right: 3px; + margin-top: 3px; + cursor: pointer; +} + +div.modindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +div.genindex-jumpbox { + border-top: 1px solid #ddd; + border-bottom: 1px solid #ddd; + margin: 1em 0 1em 0; + padding: 0.4em; +} + +/* -- general body styles --------------------------------------------------- */ + +a.headerlink { + visibility: hidden; +} + +h1:hover > a.headerlink, +h2:hover > a.headerlink, +h3:hover > a.headerlink, +h4:hover > a.headerlink, +h5:hover > a.headerlink, +h6:hover > a.headerlink, +dt:hover > a.headerlink { + visibility: visible; +} + +div.body p.caption { + text-align: inherit; +} + +div.body td { + text-align: left; +} + +.field-list ul { + padding-left: 1em; +} + +.first { + margin-top: 0 !important; +} + +p.rubric { + margin-top: 30px; + font-weight: bold; +} + +img.align-left, .figure.align-left, object.align-left { + clear: left; + float: left; + margin-right: 1em; +} + +img.align-right, .figure.align-right, object.align-right { + clear: right; + float: right; + margin-left: 1em; +} + +img.align-center, .figure.align-center, object.align-center { + display: block; + margin-left: auto; + margin-right: auto; +} + +.align-left { + text-align: left; +} + +.align-center { + text-align: center; +} + +.align-right { + text-align: right; +} + +/* -- sidebars -------------------------------------------------------------- */ + +div.sidebar { + margin: 0 0 0.5em 1em; + border: 1px solid #ddb; + padding: 7px 7px 0 7px; + background-color: #ffe; + width: 40%; + float: right; +} + +p.sidebar-title { + font-weight: bold; +} + +/* -- topics ---------------------------------------------------------------- */ + +div.topic { + border: 1px solid #ccc; + padding: 7px 7px 0 7px; + margin: 10px 0 10px 0; +} + +p.topic-title { + font-size: 1.1em; + font-weight: bold; + margin-top: 10px; +} + +/* -- admonitions ----------------------------------------------------------- */ + +div.admonition { + margin-top: 10px; + margin-bottom: 10px; + padding: 7px; +} + +div.admonition dt { + font-weight: bold; +} + +div.admonition dl { + margin-bottom: 0; +} + +p.admonition-title { + margin: 0px 10px 5px 0px; + font-weight: bold; +} + +div.body p.centered { + text-align: center; + margin-top: 25px; +} + +/* -- tables ---------------------------------------------------------------- */ + +table.docutils { + border: 0; + border-collapse: collapse; +} + +table.docutils td, table.docutils th { + padding: 1px 8px 1px 5px; + border-top: 0; + border-left: 0; + border-right: 0; + border-bottom: 1px solid #aaa; +} + +table.field-list td, table.field-list th { + border: 0 !important; +} + +table.footnote td, table.footnote th { + border: 0 !important; +} + +th { + text-align: left; + padding-right: 5px; +} + +table.citation { + border-left: solid 1px gray; + margin-left: 1px; +} + +table.citation td { + border-bottom: none; +} + +/* -- other body styles ----------------------------------------------------- */ + +ol.arabic { + list-style: decimal; +} + +ol.loweralpha { + list-style: lower-alpha; +} + +ol.upperalpha { + list-style: upper-alpha; +} + +ol.lowerroman { + list-style: lower-roman; +} + +ol.upperroman { + list-style: upper-roman; +} + +dl { + margin-bottom: 15px; +} + +dd p { + margin-top: 0px; +} + +dd ul, dd table { + margin-bottom: 10px; +} + +dd { + margin-top: 3px; + margin-bottom: 10px; + margin-left: 30px; +} + +dt:target, .highlighted { + background-color: #fbe54e; +} + +dl.glossary dt { + font-weight: bold; + font-size: 1.1em; +} + +.field-list ul { + margin: 0; + padding-left: 1em; +} + +.field-list p { + margin: 0; +} + +.refcount { + color: #060; +} + +.optional { + font-size: 1.3em; +} + +.versionmodified { + font-style: italic; +} + +.system-message { + background-color: #fda; + padding: 5px; + border: 3px solid red; +} + +.footnote:target { + background-color: #ffa; +} + +.line-block { + display: block; + margin-top: 1em; + margin-bottom: 1em; +} + +.line-block .line-block { + margin-top: 0; + margin-bottom: 0; + margin-left: 1.5em; +} + +.guilabel, .menuselection { + font-family: sans-serif; +} + +.accelerator { + text-decoration: underline; +} + +.classifier { + font-style: oblique; +} + +abbr, acronym { + border-bottom: dotted 1px; + cursor: help; +} + +/* -- code displays --------------------------------------------------------- */ + +pre { + overflow: auto; + overflow-y: hidden; /* fixes display issues on Chrome browsers */ +} + +td.linenos pre { + padding: 5px 0px; + border: 0; + background-color: transparent; + color: #aaa; +} + +table.highlighttable { + margin-left: 0.5em; +} + +table.highlighttable td { + padding: 0 0.5em 0 0.5em; +} + +tt.descname { + background-color: transparent; + font-weight: bold; + font-size: 1.2em; +} + +tt.descclassname { + background-color: transparent; +} + +tt.xref, a tt { + background-color: transparent; + font-weight: bold; +} + +h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt { + background-color: transparent; +} + +.viewcode-link { + float: right; +} + +.viewcode-back { + float: right; + font-family: sans-serif; +} + +div.viewcode-block:target { + margin: -1px -10px; + padding: 0 10px; +} + +/* -- math display ---------------------------------------------------------- */ + +img.math { + vertical-align: middle; +} + +div.body div.math p { + text-align: center; +} + +span.eqno { + float: right; +} + +/* -- printout stylesheet --------------------------------------------------- */ + +@media print { + div.document, + div.documentwrapper, + div.bodywrapper { + margin: 0 !important; + width: 100%; + } + + div.sphinxsidebar, + div.related, + div.footer, + #top-link { + display: none; + } +} \ No newline at end of file diff --git a/docs/_build/html/_static/comment-bright.png b/docs/_build/html/_static/comment-bright.png new file mode 100644 index 0000000000000000000000000000000000000000..551517b8c83b76f734ff791f847829a760ad1903 GIT binary patch literal 3500 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 A2LJ#7 literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/comment.png b/docs/_build/html/_static/comment.png new file mode 100644 index 0000000000000000000000000000000000000000..92feb52b8824c6b0f59b658b1196c61de9162a95 GIT binary patch literal 3445 zcmV-*4T|!KP)Oz@Z0f2-7z;ux~O9+4z06=<WDR*FRcSTFz- zW=q650N5=6FiBTtNC2?60Km==3$g$R3;-}uh=nNt1bYBr$Ri_o0EC$U6h`t_Jn<{8 z5a%iY0C<_QJh>z}MS)ugEpZ1|S1ukX&Pf+56gFW3VVXcL!g-k)GJ!M?;PcD?0HBc- z5#WRK{dmp}uFlRjj{U%*%WZ25jX z{P*?XzTzZ-GF^d31o+^>%=Ap99M6&ogks$0k4OBs3;+Bb(;~!4V!2o<6ys46agIcq zjPo+3B8fthDa9qy|77CdEc*jK-!%ZRYCZvbku9iQV*~a}ClFY4z~c7+0P?$U!PF=S z1Au6Q;m>#f??3%Vpd|o+W=WE9003S@Bra6Svp>fO002awfhw>;8}z{#EWidF!3EsG z3;bXU&9EIRU@z1_9W=mEXoiz;4lcq~xDGvV5BgyU zp1~-*fe8db$Osc*A=-!mVv1NJjtCc-h4>-CNCXm#Bp}I%6j35eku^v$Qi@a{RY)E3 zJ#qp$hg?Rwkvqr$GJ^buyhkyVfwECO)C{#lxu`c9ghrwZ&}4KmnvWKso6vH!8a<3Q zq36)6Xb;+tK10Vaz~~qUGsJ8#F2=(`u{bOVlVi)VBCHIn#u~6ztOL7=^<&SmcLWlF zMZgI*1b0FpVIDz9SWH+>*hr`#93(Um+6gxa1B6k+CnA%mOSC4s5&6UzVlpv@SV$}* z))J2sFA#f(L&P^E5{W}HC%KRUNwK6<(h|}}(r!{C=`5+6G)NjFlgZj-YqAG9lq?`C z$c5yc>d>VnA`E_*3F2Qp##d8RZb=H01_mm@+|Cqnc9PsG(F5HIG_C zt)aG3uTh7n6Et<2In9F>NlT@zqLtGcXcuVrX|L#Xx)I%#9!{6gSJKPrN9dR61N3(c z4Tcqi$B1Vr8Jidf7-t!G7_XR2rWwr)$3XQ?}=hpK0&Z&W{| zep&sA23f;Q!%st`QJ}G3cbou<7-yIK2z4nfCCCtN2-XOGSWo##{8Q{ATurxr~;I`ytDs%xbip}RzP zziy}Qn4Z2~fSycmr`~zJ=lUFdFa1>gZThG6M+{g7vkW8#+YHVaJjFF}Z#*3@$J_By zLtVo_L#1JrVVB{Ak-5=4qt!-@Mh}c>#$4kh<88)m#-k<%CLtzEP3leVno>={htGUuD;o7bD)w_sX$S}eAxwzy?UvgBH(S?;#HZiQMoS*2K2 zT3xe7t(~nU*1N5{rxB;QPLocnp4Ml>u<^FZwyC!nu;thW+pe~4wtZn|Vi#w(#jeBd zlf9FDx_yoPJqHbk*$%56S{;6Kv~mM9!g3B(KJ}#RZ#@)!hR|78Dq|Iq-afF%KE1Brn_fm;Im z_u$xr8UFki1L{Ox>G0o)(&RAZ;=|I=wN2l97;cLaHH6leTB-XXa*h%dBOEvi`+x zi?=Txl?TadvyiL>SuF~-LZ;|cS}4~l2eM~nS7yJ>iOM;atDY;(?aZ^v+mJV$@1Ote z62cPUlD4IWOIIx&SmwQ~YB{nzae3Pc;}r!fhE@iwJh+OsDs9zItL;~pu715HdQEGA zUct(O!LkCy1<%NCg+}G`0PgpNm-?d@-hMgNe6^V+j6x$b<6@S<$+<4_1hi}Ti zncS4LsjI}fWY1>OX6feMEuLErma3QLmkw?X+1j)X-&VBk_4Y;EFPF_I+q;9dL%E~B zJh;4Nr^(LEJ3myURP{Rblsw%57T)g973R8o)DE9*xN#~;4_o$q%o z4K@u`jhx2fBXC4{U8Qn{*%*B$Ge=nny$HAYq{=vy|sI0 z_vss+H_qMky?OB#|JK!>IX&II^LlUh#rO5!7TtbwC;iULyV-Xq?ybB}ykGP{?LpZ? z-G|jbTmIbG@7#ZCz;~eY(cDM(28Dyq{*m>M4?_iynUBkc4TkHUI6gT!;y-fz>HMcd z&t%Ugo)`Y2{>!cx7B7DI)$7;J(U{Spm-3gBzioV_{p!H$8L!*M!p0uH$#^p{Ui4P` z?ZJ24cOCDe-w#jZd?0@)|7iKK^;6KN`;!@ylm7$*nDhK&GcDTy000JJOGiWi{{a60 z|De66lK=n!32;bRa{vGf6951U69E94oEQKA00(qQO+^RV2nzr)JMUJvzW@LNr%6OX zR5;6Zk;`k`RTRfR-*ac2G}PGmXsUu>6ce?Lsn$m^3Q`48f|TwQ+_-Qh=t8Ra7nE)y zf@08(pjZ@22^EVjG*%30TJRMkBUC$WqZ73uoiv&J=APqX;!v%AH}`Vx`999MVjXwy z{f1-vh8P<=plv&cZ>p5jjX~Vt&W0e)wpw1RFRuRdDkwlKb01tp5 zP=trFN0gH^|L4jJkB{6sCV;Q!ewpg-D&4cza%GQ*b>R*=34#dW;ek`FEiB(vnw+U# zpOX5UMJBhIN&;D1!yQoIAySC!9zqJmmfoJqmQp}p&h*HTfMh~u9rKic2oz3sNM^#F zBIq*MRLbsMt%y{EHj8}LeqUUvoxf0=kqji62>ne+U`d#%J)abyK&Y`=eD%oA!36<)baZyK zXJh5im6umkS|_CSGXips$nI)oBHXojzBzyY_M5K*uvb0_9viuBVyV%5VtJ*Am1ag# zczbv4B?u8j68iOz<+)nDu^oWnL+$_G{PZOCcOGQ?!1VCefves~rfpaEZs-PdVYMiV z98ElaJ2}7f;htSXFY#Zv?__sQeckE^HV{ItO=)2hMQs=(_ Xn!ZpXD%P(H00000NkvXXu0mjfa.headerlink{display:none}h1,h2,h3,h4,h5,h6{font-weight:300}a:link,a:visited{color:#deaa09;text-decoration:none}a:hover,a:active{text-decoration:underline;color:#f6c324}.literal{color:#47375d;font-size:1em;background:#e8e2ee;padding:1px 2px;-webkit-border-radius:2px;-moz-border-radius:2px;border-radius:2px;-webkit-box-shadow:inset 0 0 0 1px #c0b2d2;-moz-box-shadow:inset 0 0 0 1px #c0b2d2;-o-box-shadow:inset 0 0 0 1px #c0b2d2;box-shadow:inset 0 0 0 1px #c0b2d2}.note{background:#8c72ac;background-image:-moz-linear-gradient(top,#8c72ac 0,#6e5691 100%);background-image:-webkit-linear-gradient(top,#8c72ac 0,#6e5691 100%);background-image:-o-linear-gradient(top,#8c72ac 0,#6e5691 100%);background-image:linear-gradient(to bottom,#8c72ac 0,#6e5691 100%);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#8c72ac',endColorstr='#6e5691',GradientType=0);-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px;-webkit-box-shadow:0 2px 3px #413155;-moz-box-shadow:0 2px 3px #413155;-o-box-shadow:0 2px 3px #413155;box-shadow:0 2px 3px #413155;padding:10px 20px 10px 70px;position:relative;color:white}.note .admonition-title{display:none}.note a{color:#fade86}.note:before{content:"";display:block;background-image:url("../img/icons.png");width:32px;height:32px;display:inline-block;font-size:40px;background-size:200px 120px;background-position:-2em -2em;position:absolute;margin:auto;top:0;bottom:0;left:20px}@media(-webkit-min-device-pixel-ratio:1.5),(min--moz-device-pixel-ratio:1.5),(-o-min-device-pixel-ratio:3/2),(min-resolution:1.5dppx){.note:before{background-image:url("../img/icons@2x.png")}}.note:before.secure{background-position:0 0}.note:before.future{background-position:-1em 0}.note:before.search{background-position:-2em 0}.note:before.nli{background-position:-3em 0}.note:before.share{background-position:0 -1em}.note:before.sync{background-position:0 -1em}.note:before.dayone{background-position:-1em -1em}.note:before.github{background-position:-2em -1em}.note:before.folders{background-position:-3em -1em}.note:before.cal{background-position:-4em -1em}.note:before.left{background-position:0 -2em}.note:before.right{background-position:-1em -2em}.note:before.info{background-position:-2em -2em}.note .literal,.note .highlight-note{color:white;background:#6b518a;padding:1px 3px;-webkit-border-radius:2px;-moz-border-radius:2px;border-radius:2px;-webkit-box-shadow:inset 0 0 0 1px #8c72ac;-moz-box-shadow:inset 0 0 0 1px #8c72ac;-o-box-shadow:inset 0 0 0 1px #8c72ac;box-shadow:inset 0 0 0 1px #8c72ac}.note .highlight-note{padding:1px 10px}.note .highlight-note pre:before{content:"$ ";color:#deaa09}.highlight{background:transparent!important}.highlight-output{background:#2f1e34;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;padding:1px 20px;margin:40px auto;width:500px;-webkit-box-shadow:0 1px 8px #a0acb7;-moz-box-shadow:0 1px 8px #a0acb7;-o-box-shadow:0 1px 8px #a0acb7;box-shadow:0 1px 8px #a0acb7;position:relative;color:#f7f8f9;font-family:"Monaco","Courier New";font-size:12pt;background:#49374e}.highlight-output #args{color:#f6f7b9}.highlight-output #output{color:#9278b5}.highlight-javascript{background:#2f1e34;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;padding:1px 20px;margin:40px auto;width:500px;-webkit-box-shadow:0 1px 8px #a0acb7;-moz-box-shadow:0 1px 8px #a0acb7;-o-box-shadow:0 1px 8px #a0acb7;box-shadow:0 1px 8px #a0acb7;position:relative;color:#f7f8f9;font-family:"Monaco","Courier New";font-size:12pt;background:#49374e}.highlight-javascript #args{color:#f6f7b9}.highlight-javascript #output{color:#9278b5}.highlight-python{background:#2f1e34;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;padding:1px 20px;margin:40px auto;width:500px;-webkit-box-shadow:0 1px 8px #a0acb7;-moz-box-shadow:0 1px 8px #a0acb7;-o-box-shadow:0 1px 8px #a0acb7;box-shadow:0 1px 8px #a0acb7;position:relative;color:#f7f8f9;font-family:"Monaco","Courier New";font-size:12pt;padding:50px 20px 10px 20px}.highlight-python #args{color:#f6f7b9}.highlight-python #output{color:#9278b5}.highlight-python:before{content:"Terminal";display:block;width:100%;position:absolute;left:0;-webkit-box-shadow:inset 0 1px 0 #f4f4f4,inset 0 -1px 0 #888;-moz-box-shadow:inset 0 1px 0 #f4f4f4,inset 0 -1px 0 #888;-o-box-shadow:inset 0 1px 0 #f4f4f4,inset 0 -1px 0 #888;box-shadow:inset 0 1px 0 #f4f4f4,inset 0 -1px 0 #888;margin-top:-50px;text-align:center;height:30px;line-height:30px;color:#777;text-shadow:0 1px 0 #ddd;-webkit-border-radius:5px 5px 0 0;-moz-border-radius:5px 5px 0 0;border-radius:5px 5px 0 0;background:#eaeaea;background-image:-moz-linear-gradient(top,#eaeaea 0,#bababa 100%);background-image:-webkit-linear-gradient(top,#eaeaea 0,#bababa 100%);background-image:-o-linear-gradient(top,#eaeaea 0,#bababa 100%);background-image:linear-gradient(to bottom,#eaeaea 0,#bababa 100%);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#eaeaea',endColorstr='#bababa',GradientType=0)}.highlight-python:after{content:"";width:48px;height:30px;position:absolute;top:0;left:10px;background:url(../img/terminal.png) no-repeat center center}.highlight-python pre{margin:0 0 10px 0}.highlight-python pre:before{content:"$ ";color:#deaa09}*:hover>a.headerlink{display:inline;color:#c0b2d2;margin-left:10px;text-decoration:none}*:hover>a.headerlink:hover{color:#725794}tt{color:#47375d;font-size:1.2em}ul li{margin-bottom:10px}div.document{max-width:900px;margin:20px auto;position:relative}div.documentwrapper{margin-left:240px;padding:0}aside{position:absolute;width:220px;top:0;color:#999}aside .logo{margin:0 auto 20px auto;display:block;width:90px;height:98px}aside h2,aside h3,aside h3 a:link,aside h3 a:visited{color:#777}aside a:link,aside a:visited{color:#999}aside a:hover,aside a:active{color:#deaa09}aside input[type=submit]{display:none}aside>ul{margin:0 4px;padding:0;list-style:none}aside>ul>li{margin-bottom:10px;font-size:18px;color:#777}aside>ul>li a:link,aside>ul>li a:visited{color:#777}aside>ul>li ul{margin:10px 0 0 0;padding-left:20px;font-size:16px;color:#999}aside>ul>li ul a:link,aside>ul>li ul a:visited{color:#999}div.footer{font-size:.8em;text-align:center;margin:40px 0;color:#999}div.footer a:link,div.footer a:visited{color:#555}@media screen and (max-width:820px){body:not(.landing){padding-top:130px}body:not(.landing) .highlight-output,body:not(.landing) .highlight-python,body:not(.landing) .highlight-javascript{width:auto;max-width:500px}body:not(.landing) .highlight-python pre{margin:-10px 0 10px 0}body:not(.landing) .highlight-python:before{height:24px!important;line-height:24px;font-size:.7em}body:not(.landing) .highlight-python:after{background:0}body:not(.landing) aside{position:static}body:not(.landing) div.documentwrapper{margin:0}body:not(.landing) h1,body:not(.landing) .section{margin:0!important}body:not(.landing) aside{background-color:#f0f0f0;width:100%;margin:5px -20px;padding:5px 20px 10px 20px}body:not(.landing) #logolink{position:absolute;top:-120px;left:50%;margin-left:-49px}}@media(-webkit-min-device-pixel-ratio:1.5),(min--moz-device-pixel-ratio:1.5),(-o-min-device-pixel-ratio:3/2),(min-resolution:1.5dppx){aside .logo,body#landing #upper #logo{width:90px;height:98px;content:url(../img/logo@2x.png)}}.icon{background-image:url("../img/icons.png");width:32px;height:32px;display:inline-block;font-size:40px;background-size:200px 120px}@media(-webkit-min-device-pixel-ratio:1.5),(min--moz-device-pixel-ratio:1.5),(-o-min-device-pixel-ratio:3/2),(min-resolution:1.5dppx){.icon{background-image:url("../img/icons@2x.png")}}.icon.secure{background-position:0 0}.icon.future{background-position:-1em 0}.icon.search{background-position:-2em 0}.icon.nli{background-position:-3em 0}.icon.share{background-position:0 -1em}.icon.sync{background-position:0 -1em}.icon.dayone{background-position:-1em -1em}.icon.github{background-position:-2em -1em}.icon.folders{background-position:-3em -1em}.icon.cal{background-position:-4em -1em}.icon.left{background-position:0 -2em}.icon.right{background-position:-1em -2em}.icon.info{background-position:-2em -2em}.pre-block{background:#2f1e34;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;padding:1px 20px;margin:40px auto;width:500px;-webkit-box-shadow:0 1px 8px #a0acb7;-moz-box-shadow:0 1px 8px #a0acb7;-o-box-shadow:0 1px 8px #a0acb7;box-shadow:0 1px 8px #a0acb7;position:relative;color:#f7f8f9;font-family:"Monaco","Courier New";font-size:12pt}.pre-block #args{color:#f6f7b9}.pre-block #output{color:#9278b5}.terminal{background:#2f1e34;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;padding:1px 20px;margin:40px auto;width:500px;-webkit-box-shadow:0 1px 8px #a0acb7;-moz-box-shadow:0 1px 8px #a0acb7;-o-box-shadow:0 1px 8px #a0acb7;box-shadow:0 1px 8px #a0acb7;position:relative;color:#f7f8f9;font-family:"Monaco","Courier New";font-size:12pt;padding:50px 20px 10px 20px}.terminal #args{color:#f6f7b9}.terminal #output{color:#9278b5}.terminal:before{content:"Terminal";display:block;width:100%;position:absolute;left:0;-webkit-box-shadow:inset 0 1px 0 #f4f4f4,inset 0 -1px 0 #888;-moz-box-shadow:inset 0 1px 0 #f4f4f4,inset 0 -1px 0 #888;-o-box-shadow:inset 0 1px 0 #f4f4f4,inset 0 -1px 0 #888;box-shadow:inset 0 1px 0 #f4f4f4,inset 0 -1px 0 #888;margin-top:-50px;text-align:center;height:30px;line-height:30px;color:#777;text-shadow:0 1px 0 #ddd;-webkit-border-radius:5px 5px 0 0;-moz-border-radius:5px 5px 0 0;border-radius:5px 5px 0 0;background:#eaeaea;background-image:-moz-linear-gradient(top,#eaeaea 0,#bababa 100%);background-image:-webkit-linear-gradient(top,#eaeaea 0,#bababa 100%);background-image:-o-linear-gradient(top,#eaeaea 0,#bababa 100%);background-image:linear-gradient(to bottom,#eaeaea 0,#bababa 100%);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#eaeaea',endColorstr='#bababa',GradientType=0)}.terminal:after{content:"";width:48px;height:30px;position:absolute;top:0;left:10px;background:url(../img/terminal.png) no-repeat center center}body#landing{background-color:#47375d;font-family:"Open Sans","Helvetica Neue",sans-serif;font-weight:300}body#landing #twitter{display:block;position:absolute;top:20px;right:20px;border:1px solid #47375d;padding:5px 10px 5px 30px;color:#47375d;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px;opacity:.7;filter:alpha(opacity= 70);background:url(../img/twitter.png) 8px center no-repeat transparent}body#landing #twitter:hover,body#landing #twitter:active{opacity:1;filter:alpha(opacity= 100);text-decoration:none}body#landing #title,body#landing .row3,body#landing .row4,body#landing #prompt{width:900px;margin:0 auto}body#landing #upper{*zoom:1;background:#f7f8f9;-webkit-box-shadow:inset 0 -6px 6px -3px #dadfe3;-moz-box-shadow:inset 0 -6px 6px -3px #dadfe3;-o-box-shadow:inset 0 -6px 6px -3px #dadfe3;box-shadow:inset 0 -6px 6px -3px #dadfe3}body#landing #upper:before,body#landing #upper:after{content:" ";display:table}body#landing #upper:after{clear:both}body#landing #upper #title{width:650px;margin:150px auto 75px auto}body#landing #upper img{float:left;margin-right:30px}body#landing #upper h1{color:#564371;font-weight:300}body#landing #upper #prompt{width:640px;margin:0 auto;*zoom:1}body#landing #upper #prompt:before,body#landing #upper #prompt:after{content:" ";display:table}body#landing #upper #prompt:after{clear:both}body#landing #upper .terminal{-webkit-border-radius:6px 6px 0 0;-moz-border-radius:6px 6px 0 0;border-radius:6px 6px 0 0;float:left;margin:0;width:500px;min-height:134px;-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}body#landing #upper .pleft,body#landing #upper .pright{text-align:center;-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box;float:left;padding-top:50px;width:70px}body#landing #upper .pleft i,body#landing #upper .pright i{opacity:.6;filter:alpha(opacity= 60)}body#landing #upper .pleft i:hover,body#landing #upper .pright i:hover{opacity:10;filter:alpha(opacity= 1000);cursor:pointer}body#landing #nav{background:#7c95ca;background-image:-moz-linear-gradient(top,#7c95ca 0,#5e7dc5 100%);background-image:-webkit-linear-gradient(top,#7c95ca 0,#5e7dc5 100%);background-image:-o-linear-gradient(top,#7c95ca 0,#5e7dc5 100%);background-image:linear-gradient(to bottom,#7c95ca 0,#5e7dc5 100%);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#7c95ca',endColorstr='#5e7dc5',GradientType=0);height:60px;-webkit-box-shadow:0 6px 6px -3px #413155;-moz-box-shadow:0 6px 6px -3px #413155;-o-box-shadow:0 6px 6px -3px #413155;box-shadow:0 6px 6px -3px #413155;text-align:center}body#landing #nav a#twitter-nav{display:none}body#landing #nav a{color:#f7f8f9;text-shadow:0 -1px 0 #253865;text-decoration:none;font-size:14pt;line-height:60px;margin:0 40px}body#landing #nav a:hover{color:#f8d055;text-shadow:0 -1px 0 #947206}body#landing #nav a.cta{background:#725794;background-image:-moz-linear-gradient(top,#725794 0,#564371 100%);background-image:-webkit-linear-gradient(top,#725794 0,#564371 100%);background-image:-o-linear-gradient(top,#725794 0,#564371 100%);background-image:linear-gradient(to bottom,#725794 0,#564371 100%);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#725794',endColorstr='#564371',GradientType=0);-webkit-box-shadow:0 1px 0 #413155;-moz-box-shadow:0 1px 0 #413155;-o-box-shadow:0 1px 0 #413155;box-shadow:0 1px 0 #413155;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px;padding:6px 10px 5px 10px;white-space:nowrap}body#landing #nav a.cta:hover{background:#f6c324;background-image:-moz-linear-gradient(top,#f6c324 0,#c59708 100%);background-image:-webkit-linear-gradient(top,#f6c324 0,#c59708 100%);background-image:-o-linear-gradient(top,#f6c324 0,#c59708 100%);background-image:linear-gradient(to bottom,#f6c324 0,#c59708 100%);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#f6c324',endColorstr='#c59708',GradientType=0);-webkit-box-shadow:0 1px 0 #947206;-moz-box-shadow:0 1px 0 #947206;-o-box-shadow:0 1px 0 #947206;box-shadow:0 1px 0 #947206;text-shadow:0 -1px 0 #947206;color:#f7f8f9}body#landing #lower{color:#f7f8f9;padding-top:40px}body#landing #lower a{color:#deaa09;text-decoration:none}body#landing #lower a:hover{color:#f8d055;text-decoration:underline}body#landing #lower .row3,body#landing #lower .row4{*zoom:1;margin-bottom:20px}body#landing #lower .row3:before,body#landing #lower .row4:before,body#landing #lower .row3:after,body#landing #lower .row4:after{content:" ";display:table}body#landing #lower .row3:after,body#landing #lower .row4:after{clear:both}body#landing #lower .row3 .col,body#landing #lower .row4 .col{position:relative;padding-left:40px;float:left;width:25%;padding-right:2%;-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}body#landing #lower .row3 .col i,body#landing #lower .row4 .col i{position:absolute;left:0;top:16px}body#landing #lower .row3 .col h3,body#landing #lower .row4 .col h3{font-size:12pt;margin-bottom:.5em}body#landing #lower .row3 .col p,body#landing #lower .row4 .col p{font-size:10pt;margin:0}body#landing #lower .row3 .col:last-child,body#landing #lower .row4 .col:last-child{padding-right:0}body#landing #lower .row3 .col{width:33.3333%}body#landing #lower .row4 .col{color:#d4d1da}body#landing #lower .row4 .col i{opacity:.8;filter:alpha(opacity= 80)}@media screen and (max-width:680px){body#landing #nav{height:auto;padding-bottom:10px}body#landing #nav a,body#landing #nav a#twitter-nav{display:block}body#landing #nav a.cta{margin:10px;padding:1px}body#landing #upper #twitter{display:none}body#landing #upper #title{margin:30px 0 10px 0}body#landing #upper #logo{backgound:red;display:block;float:none;margin:0 auto}body#landing #upper #title br{display:none}body#landing #upper .pleft,body#landing #upper .pright{display:none}body#landing #upper #prompt,body#landing #upper #title{width:100%;-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box;padding:0 20px}body#landing #upper .terminal{width:100%}}@media screen and (max-width:900px){body#landing #lower{padding:40px 20px}body#landing #lower .row3,body#landing #lower .row4{margin:0;width:auto}body#landing #lower .row3 .col,body#landing #lower .row4 .col{float:none;width:100%;text-align:center;padding:0;margin:0 0 40px 0}body#landing #lower .row3 .col h3,body#landing #lower .row4 .col h3{font-size:1.5em}body#landing #lower .row3 .col p,body#landing #lower .row4 .col p{font-size:1em}body#landing #lower .row3 .col i,body#landing #lower .row4 .col i{position:static;margin-bottom:-20px}} \ No newline at end of file diff --git a/docs/_build/html/_static/doctools.js b/docs/_build/html/_static/doctools.js new file mode 100644 index 00000000..d4619fdf --- /dev/null +++ b/docs/_build/html/_static/doctools.js @@ -0,0 +1,247 @@ +/* + * doctools.js + * ~~~~~~~~~~~ + * + * Sphinx JavaScript utilities for all documentation. + * + * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/** + * select a different prefix for underscore + */ +$u = _.noConflict(); + +/** + * make the code below compatible with browsers without + * an installed firebug like debugger +if (!window.console || !console.firebug) { + var names = ["log", "debug", "info", "warn", "error", "assert", "dir", + "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", + "profile", "profileEnd"]; + window.console = {}; + for (var i = 0; i < names.length; ++i) + window.console[names[i]] = function() {}; +} + */ + +/** + * small helper function to urldecode strings + */ +jQuery.urldecode = function(x) { + return decodeURIComponent(x).replace(/\+/g, ' '); +} + +/** + * small helper function to urlencode strings + */ +jQuery.urlencode = encodeURIComponent; + +/** + * This function returns the parsed url parameters of the + * current request. Multiple values per key are supported, + * it will always return arrays of strings for the value parts. + */ +jQuery.getQueryParameters = function(s) { + if (typeof s == 'undefined') + s = document.location.search; + var parts = s.substr(s.indexOf('?') + 1).split('&'); + var result = {}; + for (var i = 0; i < parts.length; i++) { + var tmp = parts[i].split('=', 2); + var key = jQuery.urldecode(tmp[0]); + var value = jQuery.urldecode(tmp[1]); + if (key in result) + result[key].push(value); + else + result[key] = [value]; + } + return result; +}; + +/** + * small function to check if an array contains + * a given item. + */ +jQuery.contains = function(arr, item) { + for (var i = 0; i < arr.length; i++) { + if (arr[i] == item) + return true; + } + return false; +}; + +/** + * highlight a given string on a jquery object by wrapping it in + * span elements with the given class name. + */ +jQuery.fn.highlightText = function(text, className) { + function highlight(node) { + if (node.nodeType == 3) { + var val = node.nodeValue; + var pos = val.toLowerCase().indexOf(text); + if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) { + var span = document.createElement("span"); + span.className = className; + span.appendChild(document.createTextNode(val.substr(pos, text.length))); + node.parentNode.insertBefore(span, node.parentNode.insertBefore( + document.createTextNode(val.substr(pos + text.length)), + node.nextSibling)); + node.nodeValue = val.substr(0, pos); + } + } + else if (!jQuery(node).is("button, select, textarea")) { + jQuery.each(node.childNodes, function() { + highlight(this); + }); + } + } + return this.each(function() { + highlight(this); + }); +}; + +/** + * Small JavaScript module for the documentation. + */ +var Documentation = { + + init : function() { + this.fixFirefoxAnchorBug(); + this.highlightSearchWords(); + this.initIndexTable(); + }, + + /** + * i18n support + */ + TRANSLATIONS : {}, + PLURAL_EXPR : function(n) { return n == 1 ? 0 : 1; }, + LOCALE : 'unknown', + + // gettext and ngettext don't access this so that the functions + // can safely bound to a different name (_ = Documentation.gettext) + gettext : function(string) { + var translated = Documentation.TRANSLATIONS[string]; + if (typeof translated == 'undefined') + return string; + return (typeof translated == 'string') ? translated : translated[0]; + }, + + ngettext : function(singular, plural, n) { + var translated = Documentation.TRANSLATIONS[singular]; + if (typeof translated == 'undefined') + return (n == 1) ? singular : plural; + return translated[Documentation.PLURALEXPR(n)]; + }, + + addTranslations : function(catalog) { + for (var key in catalog.messages) + this.TRANSLATIONS[key] = catalog.messages[key]; + this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); + this.LOCALE = catalog.locale; + }, + + /** + * add context elements like header anchor links + */ + addContextElements : function() { + $('div[id] > :header:first').each(function() { + $('\u00B6'). + attr('href', '#' + this.id). + attr('title', _('Permalink to this headline')). + appendTo(this); + }); + $('dt[id]').each(function() { + $('\u00B6'). + attr('href', '#' + this.id). + attr('title', _('Permalink to this definition')). + appendTo(this); + }); + }, + + /** + * workaround a firefox stupidity + */ + fixFirefoxAnchorBug : function() { + if (document.location.hash && $.browser.mozilla) + window.setTimeout(function() { + document.location.href += ''; + }, 10); + }, + + /** + * highlight the search words provided in the url in the text + */ + highlightSearchWords : function() { + var params = $.getQueryParameters(); + var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; + if (terms.length) { + var body = $('div.body'); + window.setTimeout(function() { + $.each(terms, function() { + body.highlightText(this.toLowerCase(), 'highlighted'); + }); + }, 10); + $('

' + _('Hide Search Matches') + '

') + .appendTo($('#searchbox')); + } + }, + + /** + * init the domain index toggle buttons + */ + initIndexTable : function() { + var togglers = $('img.toggler').click(function() { + var src = $(this).attr('src'); + var idnum = $(this).attr('id').substr(7); + $('tr.cg-' + idnum).toggle(); + if (src.substr(-9) == 'minus.png') + $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); + else + $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); + }).css('display', ''); + if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { + togglers.click(); + } + }, + + /** + * helper function to hide the search marks again + */ + hideSearchWords : function() { + $('#searchbox .highlight-link').fadeOut(300); + $('span.highlighted').removeClass('highlighted'); + }, + + /** + * make the url absolute + */ + makeURL : function(relativeURL) { + return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; + }, + + /** + * get the current relative url + */ + getCurrentURL : function() { + var path = document.location.pathname; + var parts = path.split(/\//); + $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { + if (this == '..') + parts.pop(); + }); + var url = parts.join('/'); + return path.substring(url.lastIndexOf('/') + 1, path.length - 1); + } +}; + +// quick alias for translations +_ = Documentation.gettext; + +$(document).ready(function() { + Documentation.init(); +}); diff --git a/docs/_build/html/_static/down-pressed.png b/docs/_build/html/_static/down-pressed.png new file mode 100644 index 0000000000000000000000000000000000000000..6f7ad782782e4f8e39b0c6e15c7344700cdd2527 GIT binary patch literal 368 zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`jKx9jP7LeL$-D$|*pj^6U4S$Y z{B+)352QE?JR*yM+OLB!qm#z$3ZNi+iKnkC`z>}Z23@f-Ava~9&<9T!#}JFtXD=!G zGdl{fK6ro2OGiOl+hKvH6i=D3%%Y^j`yIkRn!8O>@bG)IQR0{Kf+mxNd=_WScA8u_ z3;8(7x2){m9`nt+U(Nab&1G)!{`SPVpDX$w8McLTzAJ39wprG3p4XLq$06M`%}2Yk zRPPsbES*dnYm1wkGL;iioAUB*Or2kz6(-M_r_#Me-`{mj$Z%( literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/down.png b/docs/_build/html/_static/down.png new file mode 100644 index 0000000000000000000000000000000000000000..3003a88770de3977d47a2ba69893436a2860f9e7 GIT binary patch literal 363 zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`jKx9jP7LeL$-D$|*pj^6U4S$Y z{B+)352QE?JR*yM+OLB!qm#z$3ZNi+iKnkC`z>}xaV3tUZ$qnrLa#kt978NlpS`ru z&)HFc^}^>{UOEce+71h5nn>6&w6A!ieNbu1wh)UGh{8~et^#oZ1# z>T7oM=FZ~xXWnTo{qnXm$ZLOlqGswI_m2{XwVK)IJmBjW{J3-B3x@C=M{ShWt#fYS9M?R;8K$~YwlIqwf>VA7q=YKcwf2DS4Zj5inDKXXB1zl=(YO3ST6~rDq)&z z*o>z)=hxrfG-cDBW0G$!?6{M<$@{_4{m1o%Ub!naEtn|@^frU1tDnm{r-UW|!^@B8 literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/file.png b/docs/_build/html/_static/file.png new file mode 100644 index 0000000000000000000000000000000000000000..d18082e397e7e54f20721af768c4c2983258f1b4 GIT binary patch literal 392 zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`Y)RhkE)4%caKYZ?lYt_f1s;*b z3=G`DAk4@xYmNj^kiEpy*OmP$HyOL$D9)yc9|lc|nKf<9@eUiWd>3GuTC!a5vdfWYEazjncPj5ZQX%+1 zt8B*4=d)!cdDz4wr^#OMYfqGz$1LDFF>|#>*O?AGil(WEs?wLLy{Gj2J_@opDm%`dlax3yA*@*N$G&*ukFv>P8+2CBWO(qz zD0k1@kN>hhb1_6`&wrCswzINE(evt-5C1B^STi2@PmdKI;Vst0PQB6!2kdN literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/img/favicon-152.png b/docs/_build/html/_static/img/favicon-152.png new file mode 100644 index 0000000000000000000000000000000000000000..ac658d9ce73f8bddb02c753987998b52bc7325a2 GIT binary patch literal 3261 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 KtqLvc$o~M=2{qmT literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/img/favicon.ico b/docs/_build/html/_static/img/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..7c9c2c1e2ed5cbf83ae4302ce72f729bef91ea48 GIT binary patch literal 5558 zcmeHL%`XE%6d&T|LR=ks5?2>#I3RHl!G$>XAT-41!9jc+D#{6MDv^lz2&X3eCryY5 zs)?dqG)09HP1B!!Bae-*3acb$lG(SrGw=Oo-oE#;zY!u!WDAQ$=+YvJ^Mxo9LgeK= zKDXxx(V)L8*5Bz2-^vjgLB^^Cyl zp2u|e5Y}fFkxC|!xV!&0{#`td#C-y5o&{;!>zb2Tgh_rNpC4@dL4G;X_e7G`Wi~$f z#)!d~^u4LQlxE|nlBri19BT?+`QMEATXal5<^Sr0N9I50Unb&@_OLuUC2JSmQ~k*_ zKIfFeSN>P=r}9tLpU3~NOx1r?f1mk-sy~0f{+P)>jIsan|KmOWLA=u}{`C?5d;E*I zuUY)_E&O!+^SAjop9B0?N#`W`(TO}ENq0_CS7^moI(=i-(=<);ZMx9C&*zh4B#mP{ t&U!43bIjH!3}YkvjLY&Pe4fKLl)myG#{|pYiXUSR@>)JCN%y<;@c}3gBAx&M literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/img/icons.png b/docs/_build/html/_static/img/icons.png new file mode 100644 index 0000000000000000000000000000000000000000..bb77ca657d55a76a15859b2db8f53a9f6f5934f2 GIT binary patch literal 10460 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 literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/img/logo.png b/docs/_build/html/_static/img/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..1ea79cf1583927ca8bdbde9f8779fecfc567b72a GIT binary patch literal 2783 zcmc&$c{tQx7ypiZ$&w~JBZX{*kSvkNOm;#)OD3`uV;g1&W1G-e#t_n&sVpUfD3UFb z2-$ZT!p~OrefNIf|KI=L`#k5K=bn3>^PF?;IiGW%T9_GeaR_q&0KkQS8(4wd9wZkw z7I5#5YH9=-6Ivf}hYeg|Y!BkWGrJ%BA2g^x^k0JLUnB>ELZLvzyMfle?t$3*0d4>m zi@o&F#|!Ox-_PxmZ-57RSz8zYI2;iMH|_*yFHu4Qt!>03>!lwWX9m8`m%TuD$mq4o z7?re8HzY_fx(GQYw?kTjn%$Z#yZmRBIyJ~`LSo-@FTM(X;4hRQ8BO3%cgt%t6OqVA zI8fL`ksAvhZ1*YI-~0`a?9f*$!=+-IbMNZ2oLxlv6~REQb%;zU=}x zff|dqo_~1Pgoq)|Cns~S5BbVO&@(}+csz3&hl-FYsAyHeEP%E7vkKNCNv4#}KLZ^6)5IdG4n3oF(+hdas-rlq{?1IYqwA zVF_hUy4BI-)$F1jmKuOQ`3mGf!rea)+X(0?BmRR)xH|LE(QFkgGkchC7tl)IPw%s$c&TynfL%!&a)Hzj!=Z41ajHNUr%-x##+b!u7Y>Nq?UVM@Y#^(CLXq9Hz z2WEfBc{s9fB=%3kxa95ROl2jNXCnM&jIWTtb~F~vtc+x?V8Y~pm%jVlk)Zs%`u$ZY zLH85n;lHP1^Q8cbz;337XJZP1Hzmt{WkX?d5D6@fJ0^!Ups*;GF*Lz4E71)wA*Uyu z0J;DsyrN4?+m{bW+Okbv)P?AECi*wB3^=#Gc*d>waIVdy*w()zdkql1tit$eZ9qxw zDkqTE6W#Wp96-hsSsE5RbE`jaM-Dfg1Mb`{1PcWP=OtNAM#uI=ECkq$qS!^xtQ%-PtHr+D=_Qf3j4$J-}$jX$zeny2Cfcm<()vv^h8x=l#UmvNa|m|c;l zvo2SqLe{se-}3RF1Q@nzm(yTiyZ_E3ewz0>kzsB39_((iF}SUCM! z$`U57H2FxhQ)*9tx-+jmok--t;g-?ml@+0*paN>UGb{=cbzCsTM;{StH>M-rvT}1U zzACBiN%K}Jx{~XsQj!|`o$8~tfO(PPqL-dB#a|cN zf-`UUOryU`#0q@QywS4{XAxn6_?33g7au#TLtzS#dD3{5-_B`(PYZn@PiX9XAHgJX z-H<4U8nY-rcSDfp<%79x81Ou>SSx64+Z<~>7-HO-MPhHzdLM3Lym1+8OEx{bxEppE zEKimON?Wk`oPjAKi4{3#r|Tm3iC4J9t^f1u0?^bLX2KB|tgFguTepvWE2DxQzu;KH z4Zhj+PqwU88)!i)6%InBZ~cqQIQ$V{Xc_GF-6$|HkT+8mPjXEys~8Rm{cZ&OtoB#g zAHG;9_voLK*|)&hT7x!248xf2*B0|m3ADa2SCDOn&c2G#Hq4`E>Muf!lDM{tpoT1- z{qsmTc=esb)BYzP(FZ)Wn~U~Eriz(9{n2IW6{TS#j|e>JuLcXMmZ()A$gTeDJ^MV7 zAN2FXYKbF=W;0#HFaJgIku)Ra>XkJ2x; zRrZ)vT~ueC2(yGIRHS#8B7MGua)BePAcQ4Lk#>0a| zF>1z-w3FSWxgb+Fovx!bQ#pkJ(A`M`OWCJ%>a>&Gen;YRvVHhI&kH1q_e&jAbtM7r zr18<`=UVOcd)`&0+>hDUa=JWjpO{p0XfgELTn#>YJQuS&L)p>UDOmOPT7r>r`!mJU zl8#LWL!b5V@t7)2ZK<0_n(}HpGM!jqB&nSQ}G&3mCM@Ih#m%}p~ literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/img/logo@2x.png b/docs/_build/html/_static/img/logo@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..9cc3d76b6447c42cf7c19f859d3a7ccb89c01387 GIT binary patch literal 5598 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 Og4C2W70VSYg8m0xQL!Tc literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/img/terminal.png b/docs/_build/html/_static/img/terminal.png new file mode 100644 index 0000000000000000000000000000000000000000..b813980e142c26710e7fc337c68da072389a7df5 GIT binary patch literal 687 zcmV;g0#N;lP)h<1H#hI(d|Ibq=okRtC$%R;pI>f0`iTFi&2vsAA zO65}#!1JTTUT}QXW-}K#67w`tbO@9*X#EM03zYA zojiMHbm4rqMntcz#puvY48RkP@$X-#({5#nDCsy(6abjHqqVL@W2apcJFJeA^9%I* V;j=^1`V0U7002ovPDHLkV1ljcEfN3# literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/img/twitter.png b/docs/_build/html/_static/img/twitter.png new file mode 100644 index 0000000000000000000000000000000000000000..29c5a89ecaba167b599c452ee38beaecb1268ca2 GIT binary patch literal 1550 zcmV+p2J!icP)4Tx05}naRo`#hR1`jmZ&IWdKOk5~hl<6oRa0BJ8yc;~21%2p?MfD<>DVeH z9(p*dx19w`~g7O0}n_%Aq@s%d)fBDv`JHkDym6Hd+5XuAtvnwRpGmK zVkc9?T=n|PIo~X-eVh__(Z?q}P9Z-Dj?gOW6|D%o20XmjW-qs4UjrD(li^iv8@eK9k+ZFm zVRFymFOPAzG5-%Pn|1W;U4vNroTa&AxDScmEA~{ri9gr1^c?U@uwSpaNnw8l_>cP1 zd;)kMQS_;jeRSUEM_*s96y65j1$)tOrwdK{YIQMt92l|D^(E_=$Rjw{b!QT@q!)ni zR`|5oW9X5n$Wv+HVc@|^eX5yXnsHX8PF3UX~a6)MwxDE0HaPjyrlI!;jX{6Kvuh*8ej?;85ekN$?5uuCiS zBTvvVG+XTxAO{m@bvM#Jr)z6J><&E22D|vq?Y?Vkbo_DijopiF$2PET#mZ8eu=y$(ArYkv7@Ex`GL?QCc!_*KFrd&;n1r7 zqW-CFs9&fT)ZaU5gc&=gBz-DaCw(vdOp0__x+47~U6sC(E(JNe@4cTT*n6*E zVH4eoU1-&7pEV~_PRe`a7v+@vy!^5}8?Y3)UmlaER00009a7bBm000XU000XU0RWnu7ytkPkV!;AR5%gM zl1)y+Koo%An-{ z)_Xxcy3NknissZ9LVy9g5Gh8$D{$5mwW%yqK$f#z1@x!$(KQ<^P`eg=mJ$Tawy)VT z(qz8Ofes|-7p1X7xDav=tni{F%bFgD&{rFfi6YMeWudwUdkK0%K-(&f^LcuDDuZ3+ zSa;~Mb&r~CE4_&S2PufHgdGP;XqdZ1t9~{Jk2-#CNOz)_Qm?E4?FAUWE*|f4v+Fo? zPf(G1^f4QCKm+mjJ~6~`*B3d2_q0d+b1A6|^c1?Lv#irf5cTEa>E@@;YIa(pDX5JL59{>M9-~76lWQT&k0{{R307*qoM6N<$g3eFh A-v9sr literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/jquery.js b/docs/_build/html/_static/jquery.js new file mode 100644 index 00000000..7c243080 --- /dev/null +++ b/docs/_build/html/_static/jquery.js @@ -0,0 +1,154 @@ +/*! + * jQuery JavaScript Library v1.4.2 + * http://jquery.com/ + * + * Copyright 2010, John Resig + * Dual licensed under the MIT or GPL Version 2 licenses. + * http://jquery.org/license + * + * Includes Sizzle.js + * http://sizzlejs.com/ + * Copyright 2010, The Dojo Foundation + * Released under the MIT, BSD, and GPL Licenses. + * + * Date: Sat Feb 13 22:33:48 2010 -0500 + */ +(function(A,w){function ma(){if(!c.isReady){try{s.documentElement.doScroll("left")}catch(a){setTimeout(ma,1);return}c.ready()}}function Qa(a,b){b.src?c.ajax({url:b.src,async:false,dataType:"script"}):c.globalEval(b.text||b.textContent||b.innerHTML||"");b.parentNode&&b.parentNode.removeChild(b)}function X(a,b,d,f,e,j){var i=a.length;if(typeof b==="object"){for(var o in b)X(a,o,b[o],f,e,d);return a}if(d!==w){f=!j&&f&&c.isFunction(d);for(o=0;o)[^>]*$|^#([\w-]+)$/,Ua=/^.[^:#\[\.,]*$/,Va=/\S/, +Wa=/^(\s|\u00A0)+|(\s|\u00A0)+$/g,Xa=/^<(\w+)\s*\/?>(?:<\/\1>)?$/,P=navigator.userAgent,xa=false,Q=[],L,$=Object.prototype.toString,aa=Object.prototype.hasOwnProperty,ba=Array.prototype.push,R=Array.prototype.slice,ya=Array.prototype.indexOf;c.fn=c.prototype={init:function(a,b){var d,f;if(!a)return this;if(a.nodeType){this.context=this[0]=a;this.length=1;return this}if(a==="body"&&!b){this.context=s;this[0]=s.body;this.selector="body";this.length=1;return this}if(typeof a==="string")if((d=Ta.exec(a))&& +(d[1]||!b))if(d[1]){f=b?b.ownerDocument||b:s;if(a=Xa.exec(a))if(c.isPlainObject(b)){a=[s.createElement(a[1])];c.fn.attr.call(a,b,true)}else a=[f.createElement(a[1])];else{a=sa([d[1]],[f]);a=(a.cacheable?a.fragment.cloneNode(true):a.fragment).childNodes}return c.merge(this,a)}else{if(b=s.getElementById(d[2])){if(b.id!==d[2])return T.find(a);this.length=1;this[0]=b}this.context=s;this.selector=a;return this}else if(!b&&/^\w+$/.test(a)){this.selector=a;this.context=s;a=s.getElementsByTagName(a);return c.merge(this, +a)}else return!b||b.jquery?(b||T).find(a):c(b).find(a);else if(c.isFunction(a))return T.ready(a);if(a.selector!==w){this.selector=a.selector;this.context=a.context}return c.makeArray(a,this)},selector:"",jquery:"1.4.2",length:0,size:function(){return this.length},toArray:function(){return R.call(this,0)},get:function(a){return a==null?this.toArray():a<0?this.slice(a)[0]:this[a]},pushStack:function(a,b,d){var f=c();c.isArray(a)?ba.apply(f,a):c.merge(f,a);f.prevObject=this;f.context=this.context;if(b=== +"find")f.selector=this.selector+(this.selector?" ":"")+d;else if(b)f.selector=this.selector+"."+b+"("+d+")";return f},each:function(a,b){return c.each(this,a,b)},ready:function(a){c.bindReady();if(c.isReady)a.call(s,c);else Q&&Q.push(a);return this},eq:function(a){return a===-1?this.slice(a):this.slice(a,+a+1)},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},slice:function(){return this.pushStack(R.apply(this,arguments),"slice",R.call(arguments).join(","))},map:function(a){return this.pushStack(c.map(this, +function(b,d){return a.call(b,d,b)}))},end:function(){return this.prevObject||c(null)},push:ba,sort:[].sort,splice:[].splice};c.fn.init.prototype=c.fn;c.extend=c.fn.extend=function(){var a=arguments[0]||{},b=1,d=arguments.length,f=false,e,j,i,o;if(typeof a==="boolean"){f=a;a=arguments[1]||{};b=2}if(typeof a!=="object"&&!c.isFunction(a))a={};if(d===b){a=this;--b}for(;b
a"; +var e=d.getElementsByTagName("*"),j=d.getElementsByTagName("a")[0];if(!(!e||!e.length||!j)){c.support={leadingWhitespace:d.firstChild.nodeType===3,tbody:!d.getElementsByTagName("tbody").length,htmlSerialize:!!d.getElementsByTagName("link").length,style:/red/.test(j.getAttribute("style")),hrefNormalized:j.getAttribute("href")==="/a",opacity:/^0.55$/.test(j.style.opacity),cssFloat:!!j.style.cssFloat,checkOn:d.getElementsByTagName("input")[0].value==="on",optSelected:s.createElement("select").appendChild(s.createElement("option")).selected, +parentNode:d.removeChild(d.appendChild(s.createElement("div"))).parentNode===null,deleteExpando:true,checkClone:false,scriptEval:false,noCloneEvent:true,boxModel:null};b.type="text/javascript";try{b.appendChild(s.createTextNode("window."+f+"=1;"))}catch(i){}a.insertBefore(b,a.firstChild);if(A[f]){c.support.scriptEval=true;delete A[f]}try{delete b.test}catch(o){c.support.deleteExpando=false}a.removeChild(b);if(d.attachEvent&&d.fireEvent){d.attachEvent("onclick",function k(){c.support.noCloneEvent= +false;d.detachEvent("onclick",k)});d.cloneNode(true).fireEvent("onclick")}d=s.createElement("div");d.innerHTML="";a=s.createDocumentFragment();a.appendChild(d.firstChild);c.support.checkClone=a.cloneNode(true).cloneNode(true).lastChild.checked;c(function(){var k=s.createElement("div");k.style.width=k.style.paddingLeft="1px";s.body.appendChild(k);c.boxModel=c.support.boxModel=k.offsetWidth===2;s.body.removeChild(k).style.display="none"});a=function(k){var n= +s.createElement("div");k="on"+k;var r=k in n;if(!r){n.setAttribute(k,"return;");r=typeof n[k]==="function"}return r};c.support.submitBubbles=a("submit");c.support.changeBubbles=a("change");a=b=d=e=j=null}})();c.props={"for":"htmlFor","class":"className",readonly:"readOnly",maxlength:"maxLength",cellspacing:"cellSpacing",rowspan:"rowSpan",colspan:"colSpan",tabindex:"tabIndex",usemap:"useMap",frameborder:"frameBorder"};var G="jQuery"+J(),Ya=0,za={};c.extend({cache:{},expando:G,noData:{embed:true,object:true, +applet:true},data:function(a,b,d){if(!(a.nodeName&&c.noData[a.nodeName.toLowerCase()])){a=a==A?za:a;var f=a[G],e=c.cache;if(!f&&typeof b==="string"&&d===w)return null;f||(f=++Ya);if(typeof b==="object"){a[G]=f;e[f]=c.extend(true,{},b)}else if(!e[f]){a[G]=f;e[f]={}}a=e[f];if(d!==w)a[b]=d;return typeof b==="string"?a[b]:a}},removeData:function(a,b){if(!(a.nodeName&&c.noData[a.nodeName.toLowerCase()])){a=a==A?za:a;var d=a[G],f=c.cache,e=f[d];if(b){if(e){delete e[b];c.isEmptyObject(e)&&c.removeData(a)}}else{if(c.support.deleteExpando)delete a[c.expando]; +else a.removeAttribute&&a.removeAttribute(c.expando);delete f[d]}}}});c.fn.extend({data:function(a,b){if(typeof a==="undefined"&&this.length)return c.data(this[0]);else if(typeof a==="object")return this.each(function(){c.data(this,a)});var d=a.split(".");d[1]=d[1]?"."+d[1]:"";if(b===w){var f=this.triggerHandler("getData"+d[1]+"!",[d[0]]);if(f===w&&this.length)f=c.data(this[0],a);return f===w&&d[1]?this.data(d[0]):f}else return this.trigger("setData"+d[1]+"!",[d[0],b]).each(function(){c.data(this, +a,b)})},removeData:function(a){return this.each(function(){c.removeData(this,a)})}});c.extend({queue:function(a,b,d){if(a){b=(b||"fx")+"queue";var f=c.data(a,b);if(!d)return f||[];if(!f||c.isArray(d))f=c.data(a,b,c.makeArray(d));else f.push(d);return f}},dequeue:function(a,b){b=b||"fx";var d=c.queue(a,b),f=d.shift();if(f==="inprogress")f=d.shift();if(f){b==="fx"&&d.unshift("inprogress");f.call(a,function(){c.dequeue(a,b)})}}});c.fn.extend({queue:function(a,b){if(typeof a!=="string"){b=a;a="fx"}if(b=== +w)return c.queue(this[0],a);return this.each(function(){var d=c.queue(this,a,b);a==="fx"&&d[0]!=="inprogress"&&c.dequeue(this,a)})},dequeue:function(a){return this.each(function(){c.dequeue(this,a)})},delay:function(a,b){a=c.fx?c.fx.speeds[a]||a:a;b=b||"fx";return this.queue(b,function(){var d=this;setTimeout(function(){c.dequeue(d,b)},a)})},clearQueue:function(a){return this.queue(a||"fx",[])}});var Aa=/[\n\t]/g,ca=/\s+/,Za=/\r/g,$a=/href|src|style/,ab=/(button|input)/i,bb=/(button|input|object|select|textarea)/i, +cb=/^(a|area)$/i,Ba=/radio|checkbox/;c.fn.extend({attr:function(a,b){return X(this,a,b,true,c.attr)},removeAttr:function(a){return this.each(function(){c.attr(this,a,"");this.nodeType===1&&this.removeAttribute(a)})},addClass:function(a){if(c.isFunction(a))return this.each(function(n){var r=c(this);r.addClass(a.call(this,n,r.attr("class")))});if(a&&typeof a==="string")for(var b=(a||"").split(ca),d=0,f=this.length;d-1)return true;return false},val:function(a){if(a===w){var b=this[0];if(b){if(c.nodeName(b,"option"))return(b.attributes.value||{}).specified?b.value:b.text;if(c.nodeName(b,"select")){var d=b.selectedIndex,f=[],e=b.options;b=b.type==="select-one";if(d<0)return null;var j=b?d:0;for(d=b?d+1:e.length;j=0;else if(c.nodeName(this,"select")){var u=c.makeArray(r);c("option",this).each(function(){this.selected= +c.inArray(c(this).val(),u)>=0});if(!u.length)this.selectedIndex=-1}else this.value=r}})}});c.extend({attrFn:{val:true,css:true,html:true,text:true,data:true,width:true,height:true,offset:true},attr:function(a,b,d,f){if(!a||a.nodeType===3||a.nodeType===8)return w;if(f&&b in c.attrFn)return c(a)[b](d);f=a.nodeType!==1||!c.isXMLDoc(a);var e=d!==w;b=f&&c.props[b]||b;if(a.nodeType===1){var j=$a.test(b);if(b in a&&f&&!j){if(e){b==="type"&&ab.test(a.nodeName)&&a.parentNode&&c.error("type property can't be changed"); +a[b]=d}if(c.nodeName(a,"form")&&a.getAttributeNode(b))return a.getAttributeNode(b).nodeValue;if(b==="tabIndex")return(b=a.getAttributeNode("tabIndex"))&&b.specified?b.value:bb.test(a.nodeName)||cb.test(a.nodeName)&&a.href?0:w;return a[b]}if(!c.support.style&&f&&b==="style"){if(e)a.style.cssText=""+d;return a.style.cssText}e&&a.setAttribute(b,""+d);a=!c.support.hrefNormalized&&f&&j?a.getAttribute(b,2):a.getAttribute(b);return a===null?w:a}return c.style(a,b,d)}});var O=/\.(.*)$/,db=function(a){return a.replace(/[^\w\s\.\|`]/g, +function(b){return"\\"+b})};c.event={add:function(a,b,d,f){if(!(a.nodeType===3||a.nodeType===8)){if(a.setInterval&&a!==A&&!a.frameElement)a=A;var e,j;if(d.handler){e=d;d=e.handler}if(!d.guid)d.guid=c.guid++;if(j=c.data(a)){var i=j.events=j.events||{},o=j.handle;if(!o)j.handle=o=function(){return typeof c!=="undefined"&&!c.event.triggered?c.event.handle.apply(o.elem,arguments):w};o.elem=a;b=b.split(" ");for(var k,n=0,r;k=b[n++];){j=e?c.extend({},e):{handler:d,data:f};if(k.indexOf(".")>-1){r=k.split("."); +k=r.shift();j.namespace=r.slice(0).sort().join(".")}else{r=[];j.namespace=""}j.type=k;j.guid=d.guid;var u=i[k],z=c.event.special[k]||{};if(!u){u=i[k]=[];if(!z.setup||z.setup.call(a,f,r,o)===false)if(a.addEventListener)a.addEventListener(k,o,false);else a.attachEvent&&a.attachEvent("on"+k,o)}if(z.add){z.add.call(a,j);if(!j.handler.guid)j.handler.guid=d.guid}u.push(j);c.event.global[k]=true}a=null}}},global:{},remove:function(a,b,d,f){if(!(a.nodeType===3||a.nodeType===8)){var e,j=0,i,o,k,n,r,u,z=c.data(a), +C=z&&z.events;if(z&&C){if(b&&b.type){d=b.handler;b=b.type}if(!b||typeof b==="string"&&b.charAt(0)==="."){b=b||"";for(e in C)c.event.remove(a,e+b)}else{for(b=b.split(" ");e=b[j++];){n=e;i=e.indexOf(".")<0;o=[];if(!i){o=e.split(".");e=o.shift();k=new RegExp("(^|\\.)"+c.map(o.slice(0).sort(),db).join("\\.(?:.*\\.)?")+"(\\.|$)")}if(r=C[e])if(d){n=c.event.special[e]||{};for(B=f||0;B=0){a.type= +e=e.slice(0,-1);a.exclusive=true}if(!d){a.stopPropagation();c.event.global[e]&&c.each(c.cache,function(){this.events&&this.events[e]&&c.event.trigger(a,b,this.handle.elem)})}if(!d||d.nodeType===3||d.nodeType===8)return w;a.result=w;a.target=d;b=c.makeArray(b);b.unshift(a)}a.currentTarget=d;(f=c.data(d,"handle"))&&f.apply(d,b);f=d.parentNode||d.ownerDocument;try{if(!(d&&d.nodeName&&c.noData[d.nodeName.toLowerCase()]))if(d["on"+e]&&d["on"+e].apply(d,b)===false)a.result=false}catch(j){}if(!a.isPropagationStopped()&& +f)c.event.trigger(a,b,f,true);else if(!a.isDefaultPrevented()){f=a.target;var i,o=c.nodeName(f,"a")&&e==="click",k=c.event.special[e]||{};if((!k._default||k._default.call(d,a)===false)&&!o&&!(f&&f.nodeName&&c.noData[f.nodeName.toLowerCase()])){try{if(f[e]){if(i=f["on"+e])f["on"+e]=null;c.event.triggered=true;f[e]()}}catch(n){}if(i)f["on"+e]=i;c.event.triggered=false}}},handle:function(a){var b,d,f,e;a=arguments[0]=c.event.fix(a||A.event);a.currentTarget=this;b=a.type.indexOf(".")<0&&!a.exclusive; +if(!b){d=a.type.split(".");a.type=d.shift();f=new RegExp("(^|\\.)"+d.slice(0).sort().join("\\.(?:.*\\.)?")+"(\\.|$)")}e=c.data(this,"events");d=e[a.type];if(e&&d){d=d.slice(0);e=0;for(var j=d.length;e-1?c.map(a.options,function(f){return f.selected}).join("-"):"";else if(a.nodeName.toLowerCase()==="select")d=a.selectedIndex;return d},fa=function(a,b){var d=a.target,f,e;if(!(!da.test(d.nodeName)||d.readOnly)){f=c.data(d,"_change_data");e=Fa(d);if(a.type!=="focusout"||d.type!=="radio")c.data(d,"_change_data", +e);if(!(f===w||e===f))if(f!=null||e){a.type="change";return c.event.trigger(a,b,d)}}};c.event.special.change={filters:{focusout:fa,click:function(a){var b=a.target,d=b.type;if(d==="radio"||d==="checkbox"||b.nodeName.toLowerCase()==="select")return fa.call(this,a)},keydown:function(a){var b=a.target,d=b.type;if(a.keyCode===13&&b.nodeName.toLowerCase()!=="textarea"||a.keyCode===32&&(d==="checkbox"||d==="radio")||d==="select-multiple")return fa.call(this,a)},beforeactivate:function(a){a=a.target;c.data(a, +"_change_data",Fa(a))}},setup:function(){if(this.type==="file")return false;for(var a in ea)c.event.add(this,a+".specialChange",ea[a]);return da.test(this.nodeName)},teardown:function(){c.event.remove(this,".specialChange");return da.test(this.nodeName)}};ea=c.event.special.change.filters}s.addEventListener&&c.each({focus:"focusin",blur:"focusout"},function(a,b){function d(f){f=c.event.fix(f);f.type=b;return c.event.handle.call(this,f)}c.event.special[b]={setup:function(){this.addEventListener(a, +d,true)},teardown:function(){this.removeEventListener(a,d,true)}}});c.each(["bind","one"],function(a,b){c.fn[b]=function(d,f,e){if(typeof d==="object"){for(var j in d)this[b](j,f,d[j],e);return this}if(c.isFunction(f)){e=f;f=w}var i=b==="one"?c.proxy(e,function(k){c(this).unbind(k,i);return e.apply(this,arguments)}):e;if(d==="unload"&&b!=="one")this.one(d,f,e);else{j=0;for(var o=this.length;j0){y=t;break}}t=t[g]}m[q]=y}}}var f=/((?:\((?:\([^()]+\)|[^()]+)+\)|\[(?:\[[^[\]]*\]|['"][^'"]*['"]|[^[\]'"]+)+\]|\\.|[^ >+~,(\[\\]+)+|[>+~])(\s*,\s*)?((?:.|\r|\n)*)/g, +e=0,j=Object.prototype.toString,i=false,o=true;[0,0].sort(function(){o=false;return 0});var k=function(g,h,l,m){l=l||[];var q=h=h||s;if(h.nodeType!==1&&h.nodeType!==9)return[];if(!g||typeof g!=="string")return l;for(var p=[],v,t,y,S,H=true,M=x(h),I=g;(f.exec(""),v=f.exec(I))!==null;){I=v[3];p.push(v[1]);if(v[2]){S=v[3];break}}if(p.length>1&&r.exec(g))if(p.length===2&&n.relative[p[0]])t=ga(p[0]+p[1],h);else for(t=n.relative[p[0]]?[h]:k(p.shift(),h);p.length;){g=p.shift();if(n.relative[g])g+=p.shift(); +t=ga(g,t)}else{if(!m&&p.length>1&&h.nodeType===9&&!M&&n.match.ID.test(p[0])&&!n.match.ID.test(p[p.length-1])){v=k.find(p.shift(),h,M);h=v.expr?k.filter(v.expr,v.set)[0]:v.set[0]}if(h){v=m?{expr:p.pop(),set:z(m)}:k.find(p.pop(),p.length===1&&(p[0]==="~"||p[0]==="+")&&h.parentNode?h.parentNode:h,M);t=v.expr?k.filter(v.expr,v.set):v.set;if(p.length>0)y=z(t);else H=false;for(;p.length;){var D=p.pop();v=D;if(n.relative[D])v=p.pop();else D="";if(v==null)v=h;n.relative[D](y,v,M)}}else y=[]}y||(y=t);y||k.error(D|| +g);if(j.call(y)==="[object Array]")if(H)if(h&&h.nodeType===1)for(g=0;y[g]!=null;g++){if(y[g]&&(y[g]===true||y[g].nodeType===1&&E(h,y[g])))l.push(t[g])}else for(g=0;y[g]!=null;g++)y[g]&&y[g].nodeType===1&&l.push(t[g]);else l.push.apply(l,y);else z(y,l);if(S){k(S,q,l,m);k.uniqueSort(l)}return l};k.uniqueSort=function(g){if(B){i=o;g.sort(B);if(i)for(var h=1;h":function(g,h){var l=typeof h==="string";if(l&&!/\W/.test(h)){h=h.toLowerCase();for(var m=0,q=g.length;m=0))l||m.push(v);else if(l)h[p]=false;return false},ID:function(g){return g[1].replace(/\\/g,"")},TAG:function(g){return g[1].toLowerCase()}, +CHILD:function(g){if(g[1]==="nth"){var h=/(-?)(\d*)n((?:\+|-)?\d*)/.exec(g[2]==="even"&&"2n"||g[2]==="odd"&&"2n+1"||!/\D/.test(g[2])&&"0n+"+g[2]||g[2]);g[2]=h[1]+(h[2]||1)-0;g[3]=h[3]-0}g[0]=e++;return g},ATTR:function(g,h,l,m,q,p){h=g[1].replace(/\\/g,"");if(!p&&n.attrMap[h])g[1]=n.attrMap[h];if(g[2]==="~=")g[4]=" "+g[4]+" ";return g},PSEUDO:function(g,h,l,m,q){if(g[1]==="not")if((f.exec(g[3])||"").length>1||/^\w/.test(g[3]))g[3]=k(g[3],null,null,h);else{g=k.filter(g[3],h,l,true^q);l||m.push.apply(m, +g);return false}else if(n.match.POS.test(g[0])||n.match.CHILD.test(g[0]))return true;return g},POS:function(g){g.unshift(true);return g}},filters:{enabled:function(g){return g.disabled===false&&g.type!=="hidden"},disabled:function(g){return g.disabled===true},checked:function(g){return g.checked===true},selected:function(g){return g.selected===true},parent:function(g){return!!g.firstChild},empty:function(g){return!g.firstChild},has:function(g,h,l){return!!k(l[3],g).length},header:function(g){return/h\d/i.test(g.nodeName)}, +text:function(g){return"text"===g.type},radio:function(g){return"radio"===g.type},checkbox:function(g){return"checkbox"===g.type},file:function(g){return"file"===g.type},password:function(g){return"password"===g.type},submit:function(g){return"submit"===g.type},image:function(g){return"image"===g.type},reset:function(g){return"reset"===g.type},button:function(g){return"button"===g.type||g.nodeName.toLowerCase()==="button"},input:function(g){return/input|select|textarea|button/i.test(g.nodeName)}}, +setFilters:{first:function(g,h){return h===0},last:function(g,h,l,m){return h===m.length-1},even:function(g,h){return h%2===0},odd:function(g,h){return h%2===1},lt:function(g,h,l){return hl[3]-0},nth:function(g,h,l){return l[3]-0===h},eq:function(g,h,l){return l[3]-0===h}},filter:{PSEUDO:function(g,h,l,m){var q=h[1],p=n.filters[q];if(p)return p(g,l,h,m);else if(q==="contains")return(g.textContent||g.innerText||a([g])||"").indexOf(h[3])>=0;else if(q==="not"){h= +h[3];l=0;for(m=h.length;l=0}},ID:function(g,h){return g.nodeType===1&&g.getAttribute("id")===h},TAG:function(g,h){return h==="*"&&g.nodeType===1||g.nodeName.toLowerCase()===h},CLASS:function(g,h){return(" "+(g.className||g.getAttribute("class"))+" ").indexOf(h)>-1},ATTR:function(g,h){var l=h[1];g=n.attrHandle[l]?n.attrHandle[l](g):g[l]!=null?g[l]:g.getAttribute(l);l=g+"";var m=h[2];h=h[4];return g==null?m==="!=":m=== +"="?l===h:m==="*="?l.indexOf(h)>=0:m==="~="?(" "+l+" ").indexOf(h)>=0:!h?l&&g!==false:m==="!="?l!==h:m==="^="?l.indexOf(h)===0:m==="$="?l.substr(l.length-h.length)===h:m==="|="?l===h||l.substr(0,h.length+1)===h+"-":false},POS:function(g,h,l,m){var q=n.setFilters[h[2]];if(q)return q(g,l,h,m)}}},r=n.match.POS;for(var u in n.match){n.match[u]=new RegExp(n.match[u].source+/(?![^\[]*\])(?![^\(]*\))/.source);n.leftMatch[u]=new RegExp(/(^(?:.|\r|\n)*?)/.source+n.match[u].source.replace(/\\(\d+)/g,function(g, +h){return"\\"+(h-0+1)}))}var z=function(g,h){g=Array.prototype.slice.call(g,0);if(h){h.push.apply(h,g);return h}return g};try{Array.prototype.slice.call(s.documentElement.childNodes,0)}catch(C){z=function(g,h){h=h||[];if(j.call(g)==="[object Array]")Array.prototype.push.apply(h,g);else if(typeof g.length==="number")for(var l=0,m=g.length;l";var l=s.documentElement;l.insertBefore(g,l.firstChild);if(s.getElementById(h)){n.find.ID=function(m,q,p){if(typeof q.getElementById!=="undefined"&&!p)return(q=q.getElementById(m[1]))?q.id===m[1]||typeof q.getAttributeNode!=="undefined"&& +q.getAttributeNode("id").nodeValue===m[1]?[q]:w:[]};n.filter.ID=function(m,q){var p=typeof m.getAttributeNode!=="undefined"&&m.getAttributeNode("id");return m.nodeType===1&&p&&p.nodeValue===q}}l.removeChild(g);l=g=null})();(function(){var g=s.createElement("div");g.appendChild(s.createComment(""));if(g.getElementsByTagName("*").length>0)n.find.TAG=function(h,l){l=l.getElementsByTagName(h[1]);if(h[1]==="*"){h=[];for(var m=0;l[m];m++)l[m].nodeType===1&&h.push(l[m]);l=h}return l};g.innerHTML=""; +if(g.firstChild&&typeof g.firstChild.getAttribute!=="undefined"&&g.firstChild.getAttribute("href")!=="#")n.attrHandle.href=function(h){return h.getAttribute("href",2)};g=null})();s.querySelectorAll&&function(){var g=k,h=s.createElement("div");h.innerHTML="

";if(!(h.querySelectorAll&&h.querySelectorAll(".TEST").length===0)){k=function(m,q,p,v){q=q||s;if(!v&&q.nodeType===9&&!x(q))try{return z(q.querySelectorAll(m),p)}catch(t){}return g(m,q,p,v)};for(var l in g)k[l]=g[l];h=null}}(); +(function(){var g=s.createElement("div");g.innerHTML="
";if(!(!g.getElementsByClassName||g.getElementsByClassName("e").length===0)){g.lastChild.className="e";if(g.getElementsByClassName("e").length!==1){n.order.splice(1,0,"CLASS");n.find.CLASS=function(h,l,m){if(typeof l.getElementsByClassName!=="undefined"&&!m)return l.getElementsByClassName(h[1])};g=null}}})();var E=s.compareDocumentPosition?function(g,h){return!!(g.compareDocumentPosition(h)&16)}: +function(g,h){return g!==h&&(g.contains?g.contains(h):true)},x=function(g){return(g=(g?g.ownerDocument||g:0).documentElement)?g.nodeName!=="HTML":false},ga=function(g,h){var l=[],m="",q;for(h=h.nodeType?[h]:h;q=n.match.PSEUDO.exec(g);){m+=q[0];g=g.replace(n.match.PSEUDO,"")}g=n.relative[g]?g+"*":g;q=0;for(var p=h.length;q=0===d})};c.fn.extend({find:function(a){for(var b=this.pushStack("","find",a),d=0,f=0,e=this.length;f0)for(var j=d;j0},closest:function(a,b){if(c.isArray(a)){var d=[],f=this[0],e,j= +{},i;if(f&&a.length){e=0;for(var o=a.length;e-1:c(f).is(e)){d.push({selector:i,elem:f});delete j[i]}}f=f.parentNode}}return d}var k=c.expr.match.POS.test(a)?c(a,b||this.context):null;return this.map(function(n,r){for(;r&&r.ownerDocument&&r!==b;){if(k?k.index(r)>-1:c(r).is(a))return r;r=r.parentNode}return null})},index:function(a){if(!a||typeof a=== +"string")return c.inArray(this[0],a?c(a):this.parent().children());return c.inArray(a.jquery?a[0]:a,this)},add:function(a,b){a=typeof a==="string"?c(a,b||this.context):c.makeArray(a);b=c.merge(this.get(),a);return this.pushStack(qa(a[0])||qa(b[0])?b:c.unique(b))},andSelf:function(){return this.add(this.prevObject)}});c.each({parent:function(a){return(a=a.parentNode)&&a.nodeType!==11?a:null},parents:function(a){return c.dir(a,"parentNode")},parentsUntil:function(a,b,d){return c.dir(a,"parentNode", +d)},next:function(a){return c.nth(a,2,"nextSibling")},prev:function(a){return c.nth(a,2,"previousSibling")},nextAll:function(a){return c.dir(a,"nextSibling")},prevAll:function(a){return c.dir(a,"previousSibling")},nextUntil:function(a,b,d){return c.dir(a,"nextSibling",d)},prevUntil:function(a,b,d){return c.dir(a,"previousSibling",d)},siblings:function(a){return c.sibling(a.parentNode.firstChild,a)},children:function(a){return c.sibling(a.firstChild)},contents:function(a){return c.nodeName(a,"iframe")? +a.contentDocument||a.contentWindow.document:c.makeArray(a.childNodes)}},function(a,b){c.fn[a]=function(d,f){var e=c.map(this,b,d);eb.test(a)||(f=d);if(f&&typeof f==="string")e=c.filter(f,e);e=this.length>1?c.unique(e):e;if((this.length>1||gb.test(f))&&fb.test(a))e=e.reverse();return this.pushStack(e,a,R.call(arguments).join(","))}});c.extend({filter:function(a,b,d){if(d)a=":not("+a+")";return c.find.matches(a,b)},dir:function(a,b,d){var f=[];for(a=a[b];a&&a.nodeType!==9&&(d===w||a.nodeType!==1||!c(a).is(d));){a.nodeType=== +1&&f.push(a);a=a[b]}return f},nth:function(a,b,d){b=b||1;for(var f=0;a;a=a[d])if(a.nodeType===1&&++f===b)break;return a},sibling:function(a,b){for(var d=[];a;a=a.nextSibling)a.nodeType===1&&a!==b&&d.push(a);return d}});var Ja=/ jQuery\d+="(?:\d+|null)"/g,V=/^\s+/,Ka=/(<([\w:]+)[^>]*?)\/>/g,hb=/^(?:area|br|col|embed|hr|img|input|link|meta|param)$/i,La=/<([\w:]+)/,ib=/"},F={option:[1,""],legend:[1,"
","
"],thead:[1,"","
"],tr:[2,"","
"],td:[3,"","
"],col:[2,"","
"],area:[1,"",""],_default:[0,"",""]};F.optgroup=F.option;F.tbody=F.tfoot=F.colgroup=F.caption=F.thead;F.th=F.td;if(!c.support.htmlSerialize)F._default=[1,"div
","
"];c.fn.extend({text:function(a){if(c.isFunction(a))return this.each(function(b){var d= +c(this);d.text(a.call(this,b,d.text()))});if(typeof a!=="object"&&a!==w)return this.empty().append((this[0]&&this[0].ownerDocument||s).createTextNode(a));return c.text(this)},wrapAll:function(a){if(c.isFunction(a))return this.each(function(d){c(this).wrapAll(a.call(this,d))});if(this[0]){var b=c(a,this[0].ownerDocument).eq(0).clone(true);this[0].parentNode&&b.insertBefore(this[0]);b.map(function(){for(var d=this;d.firstChild&&d.firstChild.nodeType===1;)d=d.firstChild;return d}).append(this)}return this}, +wrapInner:function(a){if(c.isFunction(a))return this.each(function(b){c(this).wrapInner(a.call(this,b))});return this.each(function(){var b=c(this),d=b.contents();d.length?d.wrapAll(a):b.append(a)})},wrap:function(a){return this.each(function(){c(this).wrapAll(a)})},unwrap:function(){return this.parent().each(function(){c.nodeName(this,"body")||c(this).replaceWith(this.childNodes)}).end()},append:function(){return this.domManip(arguments,true,function(a){this.nodeType===1&&this.appendChild(a)})}, +prepend:function(){return this.domManip(arguments,true,function(a){this.nodeType===1&&this.insertBefore(a,this.firstChild)})},before:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,false,function(b){this.parentNode.insertBefore(b,this)});else if(arguments.length){var a=c(arguments[0]);a.push.apply(a,this.toArray());return this.pushStack(a,"before",arguments)}},after:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,false,function(b){this.parentNode.insertBefore(b, +this.nextSibling)});else if(arguments.length){var a=this.pushStack(this,"after",arguments);a.push.apply(a,c(arguments[0]).toArray());return a}},remove:function(a,b){for(var d=0,f;(f=this[d])!=null;d++)if(!a||c.filter(a,[f]).length){if(!b&&f.nodeType===1){c.cleanData(f.getElementsByTagName("*"));c.cleanData([f])}f.parentNode&&f.parentNode.removeChild(f)}return this},empty:function(){for(var a=0,b;(b=this[a])!=null;a++)for(b.nodeType===1&&c.cleanData(b.getElementsByTagName("*"));b.firstChild;)b.removeChild(b.firstChild); +return this},clone:function(a){var b=this.map(function(){if(!c.support.noCloneEvent&&!c.isXMLDoc(this)){var d=this.outerHTML,f=this.ownerDocument;if(!d){d=f.createElement("div");d.appendChild(this.cloneNode(true));d=d.innerHTML}return c.clean([d.replace(Ja,"").replace(/=([^="'>\s]+\/)>/g,'="$1">').replace(V,"")],f)[0]}else return this.cloneNode(true)});if(a===true){ra(this,b);ra(this.find("*"),b.find("*"))}return b},html:function(a){if(a===w)return this[0]&&this[0].nodeType===1?this[0].innerHTML.replace(Ja, +""):null;else if(typeof a==="string"&&!ta.test(a)&&(c.support.leadingWhitespace||!V.test(a))&&!F[(La.exec(a)||["",""])[1].toLowerCase()]){a=a.replace(Ka,Ma);try{for(var b=0,d=this.length;b0||e.cacheable||this.length>1?k.cloneNode(true):k)}o.length&&c.each(o,Qa)}return this}});c.fragments={};c.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(a,b){c.fn[a]=function(d){var f=[];d=c(d);var e=this.length===1&&this[0].parentNode;if(e&&e.nodeType===11&&e.childNodes.length===1&&d.length===1){d[b](this[0]); +return this}else{e=0;for(var j=d.length;e0?this.clone(true):this).get();c.fn[b].apply(c(d[e]),i);f=f.concat(i)}return this.pushStack(f,a,d.selector)}}});c.extend({clean:function(a,b,d,f){b=b||s;if(typeof b.createElement==="undefined")b=b.ownerDocument||b[0]&&b[0].ownerDocument||s;for(var e=[],j=0,i;(i=a[j])!=null;j++){if(typeof i==="number")i+="";if(i){if(typeof i==="string"&&!jb.test(i))i=b.createTextNode(i);else if(typeof i==="string"){i=i.replace(Ka,Ma);var o=(La.exec(i)||["", +""])[1].toLowerCase(),k=F[o]||F._default,n=k[0],r=b.createElement("div");for(r.innerHTML=k[1]+i+k[2];n--;)r=r.lastChild;if(!c.support.tbody){n=ib.test(i);o=o==="table"&&!n?r.firstChild&&r.firstChild.childNodes:k[1]===""&&!n?r.childNodes:[];for(k=o.length-1;k>=0;--k)c.nodeName(o[k],"tbody")&&!o[k].childNodes.length&&o[k].parentNode.removeChild(o[k])}!c.support.leadingWhitespace&&V.test(i)&&r.insertBefore(b.createTextNode(V.exec(i)[0]),r.firstChild);i=r.childNodes}if(i.nodeType)e.push(i);else e= +c.merge(e,i)}}if(d)for(j=0;e[j];j++)if(f&&c.nodeName(e[j],"script")&&(!e[j].type||e[j].type.toLowerCase()==="text/javascript"))f.push(e[j].parentNode?e[j].parentNode.removeChild(e[j]):e[j]);else{e[j].nodeType===1&&e.splice.apply(e,[j+1,0].concat(c.makeArray(e[j].getElementsByTagName("script"))));d.appendChild(e[j])}return e},cleanData:function(a){for(var b,d,f=c.cache,e=c.event.special,j=c.support.deleteExpando,i=0,o;(o=a[i])!=null;i++)if(d=o[c.expando]){b=f[d];if(b.events)for(var k in b.events)e[k]? +c.event.remove(o,k):Ca(o,k,b.handle);if(j)delete o[c.expando];else o.removeAttribute&&o.removeAttribute(c.expando);delete f[d]}}});var kb=/z-?index|font-?weight|opacity|zoom|line-?height/i,Na=/alpha\([^)]*\)/,Oa=/opacity=([^)]*)/,ha=/float/i,ia=/-([a-z])/ig,lb=/([A-Z])/g,mb=/^-?\d+(?:px)?$/i,nb=/^-?\d/,ob={position:"absolute",visibility:"hidden",display:"block"},pb=["Left","Right"],qb=["Top","Bottom"],rb=s.defaultView&&s.defaultView.getComputedStyle,Pa=c.support.cssFloat?"cssFloat":"styleFloat",ja= +function(a,b){return b.toUpperCase()};c.fn.css=function(a,b){return X(this,a,b,true,function(d,f,e){if(e===w)return c.curCSS(d,f);if(typeof e==="number"&&!kb.test(f))e+="px";c.style(d,f,e)})};c.extend({style:function(a,b,d){if(!a||a.nodeType===3||a.nodeType===8)return w;if((b==="width"||b==="height")&&parseFloat(d)<0)d=w;var f=a.style||a,e=d!==w;if(!c.support.opacity&&b==="opacity"){if(e){f.zoom=1;b=parseInt(d,10)+""==="NaN"?"":"alpha(opacity="+d*100+")";a=f.filter||c.curCSS(a,"filter")||"";f.filter= +Na.test(a)?a.replace(Na,b):b}return f.filter&&f.filter.indexOf("opacity=")>=0?parseFloat(Oa.exec(f.filter)[1])/100+"":""}if(ha.test(b))b=Pa;b=b.replace(ia,ja);if(e)f[b]=d;return f[b]},css:function(a,b,d,f){if(b==="width"||b==="height"){var e,j=b==="width"?pb:qb;function i(){e=b==="width"?a.offsetWidth:a.offsetHeight;f!=="border"&&c.each(j,function(){f||(e-=parseFloat(c.curCSS(a,"padding"+this,true))||0);if(f==="margin")e+=parseFloat(c.curCSS(a,"margin"+this,true))||0;else e-=parseFloat(c.curCSS(a, +"border"+this+"Width",true))||0})}a.offsetWidth!==0?i():c.swap(a,ob,i);return Math.max(0,Math.round(e))}return c.curCSS(a,b,d)},curCSS:function(a,b,d){var f,e=a.style;if(!c.support.opacity&&b==="opacity"&&a.currentStyle){f=Oa.test(a.currentStyle.filter||"")?parseFloat(RegExp.$1)/100+"":"";return f===""?"1":f}if(ha.test(b))b=Pa;if(!d&&e&&e[b])f=e[b];else if(rb){if(ha.test(b))b="float";b=b.replace(lb,"-$1").toLowerCase();e=a.ownerDocument.defaultView;if(!e)return null;if(a=e.getComputedStyle(a,null))f= +a.getPropertyValue(b);if(b==="opacity"&&f==="")f="1"}else if(a.currentStyle){d=b.replace(ia,ja);f=a.currentStyle[b]||a.currentStyle[d];if(!mb.test(f)&&nb.test(f)){b=e.left;var j=a.runtimeStyle.left;a.runtimeStyle.left=a.currentStyle.left;e.left=d==="fontSize"?"1em":f||0;f=e.pixelLeft+"px";e.left=b;a.runtimeStyle.left=j}}return f},swap:function(a,b,d){var f={};for(var e in b){f[e]=a.style[e];a.style[e]=b[e]}d.call(a);for(e in b)a.style[e]=f[e]}});if(c.expr&&c.expr.filters){c.expr.filters.hidden=function(a){var b= +a.offsetWidth,d=a.offsetHeight,f=a.nodeName.toLowerCase()==="tr";return b===0&&d===0&&!f?true:b>0&&d>0&&!f?false:c.curCSS(a,"display")==="none"};c.expr.filters.visible=function(a){return!c.expr.filters.hidden(a)}}var sb=J(),tb=//gi,ub=/select|textarea/i,vb=/color|date|datetime|email|hidden|month|number|password|range|search|tel|text|time|url|week/i,N=/=\?(&|$)/,ka=/\?/,wb=/(\?|&)_=.*?(&|$)/,xb=/^(\w+:)?\/\/([^\/?#]+)/,yb=/%20/g,zb=c.fn.load;c.fn.extend({load:function(a,b,d){if(typeof a!== +"string")return zb.call(this,a);else if(!this.length)return this;var f=a.indexOf(" ");if(f>=0){var e=a.slice(f,a.length);a=a.slice(0,f)}f="GET";if(b)if(c.isFunction(b)){d=b;b=null}else if(typeof b==="object"){b=c.param(b,c.ajaxSettings.traditional);f="POST"}var j=this;c.ajax({url:a,type:f,dataType:"html",data:b,complete:function(i,o){if(o==="success"||o==="notmodified")j.html(e?c("
").append(i.responseText.replace(tb,"")).find(e):i.responseText);d&&j.each(d,[i.responseText,o,i])}});return this}, +serialize:function(){return c.param(this.serializeArray())},serializeArray:function(){return this.map(function(){return this.elements?c.makeArray(this.elements):this}).filter(function(){return this.name&&!this.disabled&&(this.checked||ub.test(this.nodeName)||vb.test(this.type))}).map(function(a,b){a=c(this).val();return a==null?null:c.isArray(a)?c.map(a,function(d){return{name:b.name,value:d}}):{name:b.name,value:a}}).get()}});c.each("ajaxStart ajaxStop ajaxComplete ajaxError ajaxSuccess ajaxSend".split(" "), +function(a,b){c.fn[b]=function(d){return this.bind(b,d)}});c.extend({get:function(a,b,d,f){if(c.isFunction(b)){f=f||d;d=b;b=null}return c.ajax({type:"GET",url:a,data:b,success:d,dataType:f})},getScript:function(a,b){return c.get(a,null,b,"script")},getJSON:function(a,b,d){return c.get(a,b,d,"json")},post:function(a,b,d,f){if(c.isFunction(b)){f=f||d;d=b;b={}}return c.ajax({type:"POST",url:a,data:b,success:d,dataType:f})},ajaxSetup:function(a){c.extend(c.ajaxSettings,a)},ajaxSettings:{url:location.href, +global:true,type:"GET",contentType:"application/x-www-form-urlencoded",processData:true,async:true,xhr:A.XMLHttpRequest&&(A.location.protocol!=="file:"||!A.ActiveXObject)?function(){return new A.XMLHttpRequest}:function(){try{return new A.ActiveXObject("Microsoft.XMLHTTP")}catch(a){}},accepts:{xml:"application/xml, text/xml",html:"text/html",script:"text/javascript, application/javascript",json:"application/json, text/javascript",text:"text/plain",_default:"*/*"}},lastModified:{},etag:{},ajax:function(a){function b(){e.success&& +e.success.call(k,o,i,x);e.global&&f("ajaxSuccess",[x,e])}function d(){e.complete&&e.complete.call(k,x,i);e.global&&f("ajaxComplete",[x,e]);e.global&&!--c.active&&c.event.trigger("ajaxStop")}function f(q,p){(e.context?c(e.context):c.event).trigger(q,p)}var e=c.extend(true,{},c.ajaxSettings,a),j,i,o,k=a&&a.context||e,n=e.type.toUpperCase();if(e.data&&e.processData&&typeof e.data!=="string")e.data=c.param(e.data,e.traditional);if(e.dataType==="jsonp"){if(n==="GET")N.test(e.url)||(e.url+=(ka.test(e.url)? +"&":"?")+(e.jsonp||"callback")+"=?");else if(!e.data||!N.test(e.data))e.data=(e.data?e.data+"&":"")+(e.jsonp||"callback")+"=?";e.dataType="json"}if(e.dataType==="json"&&(e.data&&N.test(e.data)||N.test(e.url))){j=e.jsonpCallback||"jsonp"+sb++;if(e.data)e.data=(e.data+"").replace(N,"="+j+"$1");e.url=e.url.replace(N,"="+j+"$1");e.dataType="script";A[j]=A[j]||function(q){o=q;b();d();A[j]=w;try{delete A[j]}catch(p){}z&&z.removeChild(C)}}if(e.dataType==="script"&&e.cache===null)e.cache=false;if(e.cache=== +false&&n==="GET"){var r=J(),u=e.url.replace(wb,"$1_="+r+"$2");e.url=u+(u===e.url?(ka.test(e.url)?"&":"?")+"_="+r:"")}if(e.data&&n==="GET")e.url+=(ka.test(e.url)?"&":"?")+e.data;e.global&&!c.active++&&c.event.trigger("ajaxStart");r=(r=xb.exec(e.url))&&(r[1]&&r[1]!==location.protocol||r[2]!==location.host);if(e.dataType==="script"&&n==="GET"&&r){var z=s.getElementsByTagName("head")[0]||s.documentElement,C=s.createElement("script");C.src=e.url;if(e.scriptCharset)C.charset=e.scriptCharset;if(!j){var B= +false;C.onload=C.onreadystatechange=function(){if(!B&&(!this.readyState||this.readyState==="loaded"||this.readyState==="complete")){B=true;b();d();C.onload=C.onreadystatechange=null;z&&C.parentNode&&z.removeChild(C)}}}z.insertBefore(C,z.firstChild);return w}var E=false,x=e.xhr();if(x){e.username?x.open(n,e.url,e.async,e.username,e.password):x.open(n,e.url,e.async);try{if(e.data||a&&a.contentType)x.setRequestHeader("Content-Type",e.contentType);if(e.ifModified){c.lastModified[e.url]&&x.setRequestHeader("If-Modified-Since", +c.lastModified[e.url]);c.etag[e.url]&&x.setRequestHeader("If-None-Match",c.etag[e.url])}r||x.setRequestHeader("X-Requested-With","XMLHttpRequest");x.setRequestHeader("Accept",e.dataType&&e.accepts[e.dataType]?e.accepts[e.dataType]+", */*":e.accepts._default)}catch(ga){}if(e.beforeSend&&e.beforeSend.call(k,x,e)===false){e.global&&!--c.active&&c.event.trigger("ajaxStop");x.abort();return false}e.global&&f("ajaxSend",[x,e]);var g=x.onreadystatechange=function(q){if(!x||x.readyState===0||q==="abort"){E|| +d();E=true;if(x)x.onreadystatechange=c.noop}else if(!E&&x&&(x.readyState===4||q==="timeout")){E=true;x.onreadystatechange=c.noop;i=q==="timeout"?"timeout":!c.httpSuccess(x)?"error":e.ifModified&&c.httpNotModified(x,e.url)?"notmodified":"success";var p;if(i==="success")try{o=c.httpData(x,e.dataType,e)}catch(v){i="parsererror";p=v}if(i==="success"||i==="notmodified")j||b();else c.handleError(e,x,i,p);d();q==="timeout"&&x.abort();if(e.async)x=null}};try{var h=x.abort;x.abort=function(){x&&h.call(x); +g("abort")}}catch(l){}e.async&&e.timeout>0&&setTimeout(function(){x&&!E&&g("timeout")},e.timeout);try{x.send(n==="POST"||n==="PUT"||n==="DELETE"?e.data:null)}catch(m){c.handleError(e,x,null,m);d()}e.async||g();return x}},handleError:function(a,b,d,f){if(a.error)a.error.call(a.context||a,b,d,f);if(a.global)(a.context?c(a.context):c.event).trigger("ajaxError",[b,a,f])},active:0,httpSuccess:function(a){try{return!a.status&&location.protocol==="file:"||a.status>=200&&a.status<300||a.status===304||a.status=== +1223||a.status===0}catch(b){}return false},httpNotModified:function(a,b){var d=a.getResponseHeader("Last-Modified"),f=a.getResponseHeader("Etag");if(d)c.lastModified[b]=d;if(f)c.etag[b]=f;return a.status===304||a.status===0},httpData:function(a,b,d){var f=a.getResponseHeader("content-type")||"",e=b==="xml"||!b&&f.indexOf("xml")>=0;a=e?a.responseXML:a.responseText;e&&a.documentElement.nodeName==="parsererror"&&c.error("parsererror");if(d&&d.dataFilter)a=d.dataFilter(a,b);if(typeof a==="string")if(b=== +"json"||!b&&f.indexOf("json")>=0)a=c.parseJSON(a);else if(b==="script"||!b&&f.indexOf("javascript")>=0)c.globalEval(a);return a},param:function(a,b){function d(i,o){if(c.isArray(o))c.each(o,function(k,n){b||/\[\]$/.test(i)?f(i,n):d(i+"["+(typeof n==="object"||c.isArray(n)?k:"")+"]",n)});else!b&&o!=null&&typeof o==="object"?c.each(o,function(k,n){d(i+"["+k+"]",n)}):f(i,o)}function f(i,o){o=c.isFunction(o)?o():o;e[e.length]=encodeURIComponent(i)+"="+encodeURIComponent(o)}var e=[];if(b===w)b=c.ajaxSettings.traditional; +if(c.isArray(a)||a.jquery)c.each(a,function(){f(this.name,this.value)});else for(var j in a)d(j,a[j]);return e.join("&").replace(yb,"+")}});var la={},Ab=/toggle|show|hide/,Bb=/^([+-]=)?([\d+-.]+)(.*)$/,W,va=[["height","marginTop","marginBottom","paddingTop","paddingBottom"],["width","marginLeft","marginRight","paddingLeft","paddingRight"],["opacity"]];c.fn.extend({show:function(a,b){if(a||a===0)return this.animate(K("show",3),a,b);else{a=0;for(b=this.length;a").appendTo("body");f=e.css("display");if(f==="none")f="block";e.remove();la[d]=f}c.data(this[a],"olddisplay",f)}}a=0;for(b=this.length;a=0;f--)if(d[f].elem===this){b&&d[f](true);d.splice(f,1)}});b||this.dequeue();return this}});c.each({slideDown:K("show",1),slideUp:K("hide",1),slideToggle:K("toggle",1),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"}},function(a,b){c.fn[a]=function(d,f){return this.animate(b,d,f)}});c.extend({speed:function(a,b,d){var f=a&&typeof a==="object"?a:{complete:d||!d&&b||c.isFunction(a)&&a,duration:a,easing:d&&b||b&&!c.isFunction(b)&&b};f.duration=c.fx.off?0:typeof f.duration=== +"number"?f.duration:c.fx.speeds[f.duration]||c.fx.speeds._default;f.old=f.complete;f.complete=function(){f.queue!==false&&c(this).dequeue();c.isFunction(f.old)&&f.old.call(this)};return f},easing:{linear:function(a,b,d,f){return d+f*a},swing:function(a,b,d,f){return(-Math.cos(a*Math.PI)/2+0.5)*f+d}},timers:[],fx:function(a,b,d){this.options=b;this.elem=a;this.prop=d;if(!b.orig)b.orig={}}});c.fx.prototype={update:function(){this.options.step&&this.options.step.call(this.elem,this.now,this);(c.fx.step[this.prop]|| +c.fx.step._default)(this);if((this.prop==="height"||this.prop==="width")&&this.elem.style)this.elem.style.display="block"},cur:function(a){if(this.elem[this.prop]!=null&&(!this.elem.style||this.elem.style[this.prop]==null))return this.elem[this.prop];return(a=parseFloat(c.css(this.elem,this.prop,a)))&&a>-10000?a:parseFloat(c.curCSS(this.elem,this.prop))||0},custom:function(a,b,d){function f(j){return e.step(j)}this.startTime=J();this.start=a;this.end=b;this.unit=d||this.unit||"px";this.now=this.start; +this.pos=this.state=0;var e=this;f.elem=this.elem;if(f()&&c.timers.push(f)&&!W)W=setInterval(c.fx.tick,13)},show:function(){this.options.orig[this.prop]=c.style(this.elem,this.prop);this.options.show=true;this.custom(this.prop==="width"||this.prop==="height"?1:0,this.cur());c(this.elem).show()},hide:function(){this.options.orig[this.prop]=c.style(this.elem,this.prop);this.options.hide=true;this.custom(this.cur(),0)},step:function(a){var b=J(),d=true;if(a||b>=this.options.duration+this.startTime){this.now= +this.end;this.pos=this.state=1;this.update();this.options.curAnim[this.prop]=true;for(var f in this.options.curAnim)if(this.options.curAnim[f]!==true)d=false;if(d){if(this.options.display!=null){this.elem.style.overflow=this.options.overflow;a=c.data(this.elem,"olddisplay");this.elem.style.display=a?a:this.options.display;if(c.css(this.elem,"display")==="none")this.elem.style.display="block"}this.options.hide&&c(this.elem).hide();if(this.options.hide||this.options.show)for(var e in this.options.curAnim)c.style(this.elem, +e,this.options.orig[e]);this.options.complete.call(this.elem)}return false}else{e=b-this.startTime;this.state=e/this.options.duration;a=this.options.easing||(c.easing.swing?"swing":"linear");this.pos=c.easing[this.options.specialEasing&&this.options.specialEasing[this.prop]||a](this.state,e,0,1,this.options.duration);this.now=this.start+(this.end-this.start)*this.pos;this.update()}return true}};c.extend(c.fx,{tick:function(){for(var a=c.timers,b=0;b
"; +a.insertBefore(b,a.firstChild);d=b.firstChild;f=d.firstChild;e=d.nextSibling.firstChild.firstChild;this.doesNotAddBorder=f.offsetTop!==5;this.doesAddBorderForTableAndCells=e.offsetTop===5;f.style.position="fixed";f.style.top="20px";this.supportsFixedPosition=f.offsetTop===20||f.offsetTop===15;f.style.position=f.style.top="";d.style.overflow="hidden";d.style.position="relative";this.subtractsBorderForOverflowNotVisible=f.offsetTop===-5;this.doesNotIncludeMarginInBodyOffset=a.offsetTop!==j;a.removeChild(b); +c.offset.initialize=c.noop},bodyOffset:function(a){var b=a.offsetTop,d=a.offsetLeft;c.offset.initialize();if(c.offset.doesNotIncludeMarginInBodyOffset){b+=parseFloat(c.curCSS(a,"marginTop",true))||0;d+=parseFloat(c.curCSS(a,"marginLeft",true))||0}return{top:b,left:d}},setOffset:function(a,b,d){if(/static/.test(c.curCSS(a,"position")))a.style.position="relative";var f=c(a),e=f.offset(),j=parseInt(c.curCSS(a,"top",true),10)||0,i=parseInt(c.curCSS(a,"left",true),10)||0;if(c.isFunction(b))b=b.call(a, +d,e);d={top:b.top-e.top+j,left:b.left-e.left+i};"using"in b?b.using.call(a,d):f.css(d)}};c.fn.extend({position:function(){if(!this[0])return null;var a=this[0],b=this.offsetParent(),d=this.offset(),f=/^body|html$/i.test(b[0].nodeName)?{top:0,left:0}:b.offset();d.top-=parseFloat(c.curCSS(a,"marginTop",true))||0;d.left-=parseFloat(c.curCSS(a,"marginLeft",true))||0;f.top+=parseFloat(c.curCSS(b[0],"borderTopWidth",true))||0;f.left+=parseFloat(c.curCSS(b[0],"borderLeftWidth",true))||0;return{top:d.top- +f.top,left:d.left-f.left}},offsetParent:function(){return this.map(function(){for(var a=this.offsetParent||s.body;a&&!/^body|html$/i.test(a.nodeName)&&c.css(a,"position")==="static";)a=a.offsetParent;return a})}});c.each(["Left","Top"],function(a,b){var d="scroll"+b;c.fn[d]=function(f){var e=this[0],j;if(!e)return null;if(f!==w)return this.each(function(){if(j=wa(this))j.scrollTo(!a?f:c(j).scrollLeft(),a?f:c(j).scrollTop());else this[d]=f});else return(j=wa(e))?"pageXOffset"in j?j[a?"pageYOffset": +"pageXOffset"]:c.support.boxModel&&j.document.documentElement[d]||j.document.body[d]:e[d]}});c.each(["Height","Width"],function(a,b){var d=b.toLowerCase();c.fn["inner"+b]=function(){return this[0]?c.css(this[0],d,false,"padding"):null};c.fn["outer"+b]=function(f){return this[0]?c.css(this[0],d,false,f?"margin":"border"):null};c.fn[d]=function(f){var e=this[0];if(!e)return f==null?null:this;if(c.isFunction(f))return this.each(function(j){var i=c(this);i[d](f.call(this,j,i[d]()))});return"scrollTo"in +e&&e.document?e.document.compatMode==="CSS1Compat"&&e.document.documentElement["client"+b]||e.document.body["client"+b]:e.nodeType===9?Math.max(e.documentElement["client"+b],e.body["scroll"+b],e.documentElement["scroll"+b],e.body["offset"+b],e.documentElement["offset"+b]):f===w?c.css(e,d):this.css(d,typeof f==="string"?f:f+"px")}});A.jQuery=A.$=c})(window); diff --git a/docs/_build/html/_static/js/landing.js b/docs/_build/html/_static/js/landing.js new file mode 100644 index 00000000..0f704aa9 --- /dev/null +++ b/docs/_build/html/_static/js/landing.js @@ -0,0 +1,92 @@ +var phrases = [ + ["", "today: Started writing my memoirs. On the command line. Like a boss.", ""], + ["", "yesterday 2pm: used jrnl to keep track of accomplished tasks. The done.txt for my todo.txt", ""], + ["-from 2009 -until may", "", "(Displays all entries from January 2009 to last may)"], + ["", "A day on the beach with @beth and @frank. Taggidy-tag-tag.", ""], + ["--tags", "", "@idea 7
@beth 5"], + ["--export json", "", "(Exports your entire journal to json)"], + ["--encrypt", "", "(256 bit AES encryption. Crack this, NSA.)"] +] + +var args = document.getElementById("args"); +var input = document.getElementById("input"); +var output = document.getElementById("output"); +var right = document.getElementById("right"); +var left = document.getElementById("left"); +var current = 0 +var timer = null; + +var next = function() { + clearTimeout(timer); + reveal(++current % phrases.length); + setTimeout(next, 5000); +} +var prev = function() { + reveal(--current % phrases.length); +} + +var reveal = function(idx) { + var args_text = phrases[idx][0]; + var input_text = phrases[idx][1]; + var output_text = phrases[idx][2]; + var old_dix = idx == 0 ? phrases.length - 1 : idx - 1; + console.log(idx, old_dix, "++++++++++++") + var old_args_text = phrases[old_dix][0] + var old_input_text = phrases[old_dix][1] + var old_output_text =phrases[old_dix][2] + console.log(args_text, input_text, output_text) + console.log(old_args_text, old_input_text, old_output_text) + var s4 = function() {fadeIn(output_text, output);} + var s3 = function() {letter(input_text, input, s4);} + var s2 = function() {letter(args_text, args, s3);} + var s1 = function() {unletter(old_args_text, args, s2);} + var s0 = function() {unletter(old_input_text, input, s1);} + fadeOut(old_output_text, output, s0, 10); + // letter(input_text, input); + // output.innerHTML = output_text; +} +var fadeIn = function(text, element, next, step) { + step = step || 0 + var nx = function() { fadeIn(text, element, next, ++step); } + if (step==0) { + element.innerHTML = ""; + setTimeout(nx, 550); + return; + } + if (step==1) {element.innerHTML = text;} + if (step>10 || !text) { if (next) {next(); return;} else return;} + element.style.opacity = (step-1)/10; + element.style.filter = 'alpha(opacity=' + (step-1)*10 + ')'; + setTimeout(nx, 50); +} +var fadeOut = function(text, element, next, step) { + if (step===10) element.innerHTML = text; + if (step<0 || !text) { + element.innerHTML = ""; + if (next) {next(); return;} + else return; + } + element.style.opacity = step/10; + element.style.filter = 'alpha(opacity=' + step*10 + ')'; + var nx = function() { fadeOut(text, element, next, --step); } + setTimeout(nx, 50); +} + +var unletter = function(text, element, next, timeout, index) { + timeout = timeout||10; + if (index==null) index = text.length; + if (index==-1 || !text.length) { if (next) {next(); return;} else return;} + element.innerHTML = text.substring(0, index); + var nx = function() { unletter(text, element, next, timeout, --index); } + setTimeout(nx, timeout); +} + +var letter = function(text, element, next, timeout, index) { + timeout = timeout||35; + index = index||0; + if (index > text.length || !text.length) { if (next) {next(); return;} else return;} + element.innerHTML = text.substring(0, index); + var nx = function() { letter(text, element, next, timeout, ++index); } + setTimeout(nx, timeout); +} +setTimeout(next, 3000); diff --git a/docs/_build/html/_static/landing.svg b/docs/_build/html/_static/landing.svg new file mode 100644 index 00000000..cbdb9488 --- /dev/null +++ b/docs/_build/html/_static/landing.svg @@ -0,0 +1,3558 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + Collect your thoughts and noteswithout leaving the command line. + + + + + + + + + + + + + + + + + + + + + + + + + + Terminal + Terminal + + $ jrnl today: Started writing my Memoirs. On the command line. Like a boss. + + + + + + + + + + + + Collect your thoughts and noteswithout leaving the command line. + Secure.Ecnrypt your Journal with military-grade AES encryption so not even the NSA can read your dirty secrets. Human friendly. jrnl has a natural language interface so you don't have to remember cryptic shortcuts while writing down your thoghts. Future-proof.Your journals are stored as plain-text files and you will still be able to open them in 50 years when all your fancy iPad apps have gone the way of the Dodo. Accessible Anywhere.Ecnrypt your Journal with military-grade AES encryption so not even the NSA can read your dirty secrets. DayOne compatible.Your journals are stored as plain-text files and you will still be able to open them in 50 years when all . Free & Open SourceYour journals are stored as plain-text files and you will still be able to open them in 50 years when all . DayOne compatible.Your journals are stored as plain-text files and you will still be able to open them in 50 years when all . + + + + + + Download + + + Download + Documentation + Documentation + Fork me on Github + Fork me on Github + + jrnl is lovingly crafter by Manuel Ebert and other great people. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/_build/html/_static/less/3L.less b/docs/_build/html/_static/less/3L.less new file mode 100644 index 00000000..583c51f7 --- /dev/null +++ b/docs/_build/html/_static/less/3L.less @@ -0,0 +1,1369 @@ +///* +// * 3L was made for YOU to help you create awesome websites +// * and fill the Internet with excessive amount of Love! ♥ +// * +// * Keep up your good work! +// * +// * Yours faithfully, +// * Mateusz Kocz -> http://radiatingstar.com +// * +// * 3L: -> http://mateuszkocz.github.com/3l +// * +// * Watch 3L on Github: -> https://github.com/mateuszkocz/3l +// * +// * Submit a bug issue: -> https://github.com/mateuszkocz/3l/issues?state=open +// * +// * +// * Licensed under the Apache License v2.0 +// * http://www.apache.org/licenses/LICENSE-2.0 +// * +// * Version: 1.4.0-beta (2012.12.06) +// * +// */ + +///* +// * To compile all of the code you need to use a compiler +// * that supports JavaScript code and guarder mixins. +// * WinLess meets those requirements. You can find it on winless.org +// * +// * If you're on a Mac and your compiler meets the requirements, +// * please, let me know via Twitter or GitHub! +// * +// */ + +///* ACTIVATE SUPPORTING CLASSES */ +///* Uncomment ones you want to use or put them in html or body elements in your style sheet. */ +///* For the explanation what those classes do, read further. */ + + //html { // If you want to use those classes, uncomment also the html element. + //.seo-helper; + //.box-sizing() // Put in the brackets box-model you want to use. + //} // CAUTION! If you're using any of those supporting classes, uncomment that bracket! + +///* +// * SEO & HTML Debugging +// * +// * A useful supporting class that will help a bit with your SEO +// * and usability of your website. +// * +// * Creating a website is a serious business, but sometimes you may +// * forget about some important details. This class will help you. +// * It will let you know when you haven't put an alt attribute on image +// * or kept that attribute empty, when you haven't typed a URL in anchor or when +// * anchor link has rel=nofollow attribute. It will also show you an alert +// * message if you don't have a tag and description or left them empty*. +// * +// * If any of the errors described above happens, according element will +// * get a red outline border drawing your attention and asking for some love +// * or you will get a message with the same purpose. +// * +// * *** * The <title> reminder can alert you even if you have a <title> tag. +// * *** This happens if you have a <link> tag (usually used for style sheets) +// * *** before <title> in your HTML. Just change the order of <link> and +// * *** <title> and you're cool. +// * +// * How to: +// * Place the .seo-helper class in html element. That's it! +// * +// * *** Example: html {.seo-helper} +// * +// * That way every element on your page will be affected +// * by this rule. You can also place it in any other container +// * class element in your code (body, div.wrapper, article and so on) +// * if you don't want for some reasons to check for bugs on whole page +// * but in a single area. +// * +// * Caution! Do not forget to delete this class before finishing your +// * project, unless you want to keep it in continuous project (like blog) +// * and debug every new content on your site. But then you might consider +// * restyling this class to be a bit more eye-pleasing. +// * +// * This may not work in every browser, but since you are a web +// * developer/designer you're probably already using a bleeding +// * edge nightly alpha back-door version of browser, so no problem! +// * It's probably the only class you don't need to care about how +// * your visitors will see it! +// * +// * *** Aside - How it works: +// * *** Section only for people who don't know yet what attribute +// * *** selectors and negation pseudo-class are. +// * *** +// * *** Using negation pseudo-class is like saying "target every element x +// * *** that doesn't have attribute y" or "target every element exept (but 'not') z". +// * *** You can read more about that here ->www.w3.org/TR/selectors/#negation. +// * *** +// * *** Attribute selectors are rules that target elements that have +// * *** some specified attributes (rel, alt, href etc.) and/or specified +// * *** value of this attributes. Read more on this topic here +// * *** ->www.w3.org/TR/selectors/#selectors. +// * +// * For a further explanation and a demo, refer to: +// * -> http://radiatingstar.com/how-to-improve-seo-with-css +// * +// * Why img:not([alt]), img[alt=""] and img[alt^=" "]? +// * First targets images that don't have an alt attribute, second targets +// * ones that have this attribute but it's left empty (probably left by +// * automatic completion of html editor), third is just in case - it +// * might have been left by html editor or manually "to do it later" (clearly +// * a space at the beginning of an alt can't be anything good). +// * +// * Why a[href=""]? +// * If you write an anchor text and leave href to copyPaste URL later, +// * it will reminding you about that. +// * +// * Why a[rel="nofollow"]? +// * For some reasons links on your site may have this attribute and this +// * may generate a huge SEO problem. Better fix it ASAP. (On the other hand +// * nofollow links might be useful in some situations. See here: +// * -> http://en.wikipedia.org/wiki/Nofollow#Control_internal_PageRank_flow) +// * +// * Why div:empty, span:empty, li:empty, p:empty, td:empty, th:empty? +// * It'll just check if you have some redundancy (empty elements) in you code. +// * +// */ + +.seo-helper () { + img:not([alt]), img[alt=""], img[alt^=" "], + a[href=""], a[href^=" "], a[href="#"], a[rel*="nofollow"], + div:empty, span:empty, li:empty, p:empty, td:empty, th:empty, + *[title=""], *[class=""], *[id=""] { + outline: 2px solid red !important; + outline-offset: 3px !important; + } + head, title:empty, link, meta {display: block;} + title:empty:before {content: "You've left the <title> empty!"} + link:before {content: "You don't have a <title>!"} + title ~ link {display: none;} + meta[name="description"][content=""]:before, meta[name="description"][content=" "]:before {content: "You've left description empty!";} + } + +///* +// * Helper classes from HTML5 Boilerplate +// * +// * Classes below help you create a better user experience for both users +// * of browsers and screen readers. Oh, and there's also a clearfix! +// * +// * All the classes comes from HTML5 Boilerplate (-> html5boilerplate.com). Here though, +// * they're changed so that they can be easily used in The LESS Way. +// * They're called "non-semantic" in H5B, but here they become semantic if used well. +// * (Actually they can't be used in any way than good in 3L.) +// * (Actually II they can be semantic in H5B as well, but it's a bit pain to do that.) +// * +// * Usage: +// * Just put them in your classes, id's or elements. +// * +// * Example: +// * .YOUR-AWESOME-CLASS-NAME { +// * // some rules +// * .clearfix; +// * } +// * +// */ + +// For image replacement. +.ir () {border: 0; overflow: hidden; background-color: transparent; *text-indent: -9999px; &:before {content: ""; display: block; width: 0; height: 100%;}} + +// Hide from both screenreaders and browsers: h5bp.com/u +.hidden () {display: none !important; visibility: hidden;} + +// Hide only visually, but have it available for screenreaders: h5bp.com/v +.visuallyhidden () {border: 0;clip: rect(0 0 0 0);height: 1px;margin: -1px;overflow: hidden;padding: 0;position: absolute;width: 1px;} + +// Extends the .visuallyhidden class to allow the element to be focusable when navigated to via the keyboard: h5bp.com/p +// CAUTION! The .visuallyhidden class is included! If you want your object be both +// .visuallyhidden and .focusabe use only .focusable class. +.focusable () {.visuallyhidden;&:active,&:focus{clip: auto; height: auto; margin: 0; overflow: visible; position: static; width: auto;}} + +// Hide visually and from screenreaders, but maintain layout. +.invisible () {visibility: hidden;} + +// Contain floats: h5bp.com/q +.clearfix () {*zoom:1;&:before,&:after{content:" ";display:table;}&:after{clear:both;}} + +///* +// * Some other helper classes. +// */ + +.incomplete() {outline: 3px dotted green} +.fixme() {outline: 3px dotted yellow} +.todo() {outline: 3px dotted blue} +.xxx() {outline: 3px dotted red} + +///* +// * Box-sizing +// * +// * Change the basic box-model to the one you want. +// * +// * Basic box-model defines the width and height of an object only as a size of +// * object's content area. In order to know exactly how big is the object you need +// * to add its padding and borders. This may result in many unwanted behaviours. +// * That's why you can define how you want the browser to calculate the width/height: +// * with or without padding, with or without borders. +// * +// * To use this feature just put a value you want: +// * -- content-box ("content" works too) - it's default value from basic model. +// * -- padding-box (also "padding") - width and height declarations will include paddings. +// * -- border-box (and "border") - border and padding included. +// * +// * Usage: +// * 1. .box-sizing(content-box), .box-sizing(content) and .content-box-sizing* for box-sizing: content-box. +// * 2. .box-sizing(padding-box), .box-sizing(padding) and .padding-box-sizing* for box-sizing: padding-box. +// * 3. .box-sizing(border-box), .box-sizing(padding) and .border.box-sizing* for box-sizing: border-box. +// * +// * * Beware not to use those properties without -sizing suffix thus suffixless classes are for background-clip (see this class below). +// * +// * Resources: +// * -- http://paulirish.com/2012/box-sizing-border-box-ftw/ +// * +// * Browsers support: IE8+ and every other. +// * Notable lack of support: IE7- +// * +// */ + +.content-box-sizing(){-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box;} +.padding-box-sizing(){-moz-box-sizing:padding-box;-webkit-box-sizing:padding-box;box-sizing:padding-box;} +.border-box-sizing(){-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box;} +.box-sizing (padding) {.padding-box-sizing;} +.box-sizing (padding-box){.padding-box-sizing;} +.box-sizing (border){.border-box-sizing;} +.box-sizing (border-box){.border-box-sizing;} +.box-sizing (content){.content-box-sizing;} +.box-sizing (content-box){.content-box-sizing;} + +///* +// * Background-clip +// * +// * Clips the object's background to the desired box according to the box-model. +// * +// * To use this class simply put into an object a .background-clip(box) class, +// * where box means the desired box (see below). You can also use a shorter class +// * .bg-clip or class that corresponds to the clipping you want to get (.content-clip, +// * .padding-clip, .border-clip). +// * +// * Arguments that comes into (box) are: +// * -- content-box or content for content clip, +// * -- padding-box or padding for padding clip, +// * -- border-box or border for border clip. +// * *** You can use values either with or without "-box" suffix. +// * +// * Browsers support: IE9+ and every other. +// * Notable lack of support: IE8- +// * +// */ + +.content-box(){-moz-background-clip:content;background-clip:content-box;} +.padding-box(){-moz-background-clip:padding;background-clip:padding-box;} +.border-box(){-moz-background-clip:border;background-clip:border-box;} +.background-clip (padding){.padding-box;} +.background-clip (padding-box){.padding-box;} +.background-clip (border){.border-box;} +.background-clip (border-box){.border-box;} +.background-clip (content){.content-box;} +.background-clip (content-box){.content-box;} +.bg-clip(@arguments){.background-clip(@arguments);} + +///* +// * Box-shadow +// * Create a shadow behind or inside the element. +// * +// * Usage: +// * In .box-shadow() brackets put arguments for every single shadow. Separate +// * each shadows' arguments with comma. You can put up to five shadows +// * by default but feel free to add a class with as many as you want. +// * Just check how it is done. +// * +// * You can use a default box-shadow which will create a shadow with +// * 0px x and 1px y offsets, 3px of blur and in black colour with 25% transparency. +// * Just place a .box-shadow class without any arguments. +// * +// * Box-shadow property takes following arguments: +// * +// * 1. inset [optional]. +// * 2. x-offset [required]. +// * 3. y-offset [required]. +// * 4. blur [optional]. +// * 5. spread [optional]. +// * 6. color [optional/required]. +// * +// * Resources: +// * -- developer.mozilla.org/en/CSS/box-shadow +// * +// * Browsers support: IE9, Fx3.5, Chrome, Opera, Safari, Opera Mobile, Android Browser +// * Notable lack of support: IE8-, Opera Mini +// * +// * Example: +// * Two box-shadows: one is 1px offset, black, second one is green with 30% opacity, inset, +// * with 5px offsets, 3px of blur and 1px spread. +// * .box-shadow(1px 1px black, inset 5px 5px 3px 1px fade(green,30%)) // fade(colour,XX%) is a LESS native function +// * // that adds alpha channel to colour. Instead of fade() +// * // you can also use rgba or hsla colours declaration. +// * Solution for multiple box-shadows in a single mixin taken from http://www.toekneestuck.com/blog/2012/05/15/less-css-arguments-variable/ +// */ + +.box-shadow(@shadow1, @shadow2:X, ...){ + @shadows: ~`"@{arguments}".replace(/[\[\]]|\,\sX/g, '')`; + -webkit-box-shadow: @shadows; + -moz-box-shadow: @shadows; + -o-box-shadow: @shadows; + box-shadow: @shadows; +} + +///* +// * Border-radius +// * Round the element's corners. +// * +// * Usage: +// * Border-radius property takes one to four arguments with px, em and % +// * values and round the element's corners accordingly. You can make +// * ellipticaly roundeded corners putting two sets of values separated with +// * comma using .elliptical-border-radius class. In order to round a single +// * corner use .round-corner class. This class takes two sets of arguments. +// * First one is a declaration of corner you want to round (top-left, top-right, +// * bottom-right, bottom-left), second one (separated from the first with comma), +// * is a set of values in px, em or % that round choosen corner. Second +// * declaration can have one (for circle rounding) or two values (for +// * elliptical rounding). +// * +// * For further explanation of the border-radius property, refer to the +// * resources section above. +// * +// * Resources: +// * -- developer.mozilla.org/en/CSS/border-radius +// * +// * Browsers support: IE9, Fx3.5, Chrome, Opera, Safari, Opera Mobile, Android Browser +// * Notable lack of support: IE8-, Opera Mini +// * +// * Example: +// * 1. Round every corner of the element with 10px radius. +// * .border-radius(10px) +// * 2. Round top-left and bottom-right corners by 10px, top-right +// * and bottom-left corners by 20px. +// * .border-radius(10px 20px) +// * 3 Exemplary use of the .elliptical-border-radius class. +// * .elliptical-border-radius(10px 20px 30px, 40px 50px 60px 70px) +// * 4. Round top-right corner by 10px and 20px (elliptical). +// * .round-corner(top-right, 10px 20px) +// * .border-top-right-radius(10px 20px) // Alternate method. +// * 5. Round similar corners. +// * .border-top-radius(20px 10px); // top-left + top-right (elliptical) +// * .border-left-radius(5px); // top-left + bottom-left +// * +// */ + +// If your rounded corners looks bad with borders add this class to your rounded element. +// -> http://tumble.sneak.co.nz/post/928998513/fixing-the-background-bleed +.border-radius-fix(){.background-clip(padding-box);} + +.border-radius (@radius:5px, ...) { + -webkit-border-radius: @arguments; + -moz-border-radius: @arguments; + border-radius: @arguments; +} +// Alternate name for .border-radius. +.round-corners (@radius:5px, ...) {.border-radius(@arguments);} + +.elliptical-border-radius (@radius1, @radius2) { + -webkit-border-radius: @radius1 ~"/" @radius2; + -moz-border-radius: @radius1 ~"/" @radius2; + border-radius: @radius1 ~"/" @radius2; +} +.round-corner (top-left, @radius...){ + -webkit-border-top-left-radius: @radius; + -moz-border-top-left-radius: @radius; + border-top-left-radius: @radius; +} +.round-corner (top-right, @radius...){ + -webkit-border-top-right-radius: @radius; + -moz-border-top-right-radius: @radius; + border-top-right-radius: @radius; +} +.round-corner (bottom-right, @radius...) { + -webkit-border-bottom-right-radius: @radius; + -moz-border-bottom-right-radius: @radius; + border-bottom-right-radius: @radius; +} +.round-corner (bottom-left, @radius...) { + -webkit-border-bottom-left-radius: @radius; + -moz-border-bottom-left-radius: @radius; + border-bottom-left-radius: @radius; +} +// Another methods to use corner radius. +.border-top-left-radius (...) {.round-corner(top-left,@arguments);} +.border-top-right-radius (...) {.round-corner(top-right,@arguments);} +.border-bottom-right-radius (...) {.round-corner(bottom-right,@arguments);} +.border-bottom-left-radius (...) {.round-corner(bottom-left,@arguments);} + +// Round similar corners. +.border-top-radius (...) {.round-corner(top-left,@arguments);.round-corner(top-right,@arguments);} +.border-bottom-radius (...) {.round-corner(bottom-left,@arguments);.round-corner(bottom-right,@arguments);} +.border-left-radius (...) {.round-corner(top-left,@arguments);.round-corner(bottom-left,@arguments);} +.border-right-radius (...) {.round-corner(top-right,@arguments);.round-corner(bottom-right,@arguments);} + +// Another classes for the same purpose as above. +.round-top-corners (...) {.border-top-radius(@arguments);} +.round-bottom-corners (...) {.border-bottom-radius(@arguments);} +.round-left-corners (...) {.border-left-radius(@arguments);} +.round-right-corners (...) {.border-right-radius(@arguments);} + +///* +// * Opacity +// * Make an object transparent. +// * +// * Opacity takes values between 0.0 (invisible) to 1.0 (default - full +// * visibility) but 3L lets you also use percentages and values from >1 to 100. +// * +// * If you want an element with transparency 1, .5 or 0, use these classes: +// * .not-transparent., .half-transparent, .transparent. +// * +// * Browsers support: full (IE6+) +// * Caution! According to -> caniuse.com/#search=opacity, transparency doesn't +// * work well with PNG images that are itself transparent (use alpha channel) in IE8-. +// * +// * Aside: +// * Do we need the ability to set opacity in numbers from 1 to 100 +// * and in percentages? I think we do, because: +// * 1. You need to use integer numbers in filter property for IE, +// * so there is a possibility that someone will type this kind +// * of value, instead of [0,1]. +// * 2. LESS has a fade() function that uses percentages to makes +// * colours (semi)transparent, so using percentages here will +// * result in more consistent code (same unit in similar situation). +// * 3. Percentages are more intuitive when it comes to transparency and +// * opacity since graphic editors like Photoshop and GIMP use them. +// * +// */ + +.transparent() {.opacity(0);} +.non-transparent() {.opacity(1);} +.half-transparent () {.opacity(.5);} +.opacity () {.non-transparent();} +.opacity (@value) when (isnumber(@value)) and (@value =< 1){ + opacity: @value; + filter: ~"alpha(opacity="@value*100~")"; + } +.opacity (@value) when (isnumber(@value)) and (@value > 1) and not (ispercentage(@value)){ + // INFO: for the explanation of rule "and not (ispercentage(@value))" refer to the class below. + opacity: @value/100; + filter: ~"alpha(opacity="@value~")"; + } +.opacity (@value) when (ispercentage(@value)) { + // Change the @value from percentage to integer (XX% => XX) + @integerValue: `parseInt('@{value}')`; + // Actually the @value should be a number now... but it isn't. + // LESS think of it as a string so we can't do math here. + // We'll use a feature of LESS that automatically makes + // a second value's unit in a sum to be the same as the first one. + // In our case we need a number so we can divide it by 100. + opacity: (0 + @integerValue) /100; + // We don't need a math in filter so no trick. + filter: ~"alpha(opacity="@integerValue~")"; + + // BUG: WinLESS compile this with doubled properties unless the rule + // "and not (ispercentage(@value))" is added in the class above. + // In Firebug (through the LESS native compiler) those properties + // aren't doubled, though. + } + +///* +// * Gradient +// * Create a beautiful gradient without images. +// * +// * Pick a type of a gradient you want to have and put colours in +// * brackets. You can put either two or three colours. In the first case +// * the default colour for old browsers will be the same as the first colour provided. +// * In the second case you can set that colour as a third argument. +// * +// * The default class - .gradient - is the same as .vertical-gradient. +// * +// * You can choose from four types of gradients: +// * 1. Vertical - colour will change from top to bottom. +// * 2. Horizontal - change is from left to right. +// * 3. Diagonal - from top-left to bottom-right. +// * 4. Radial - from the centre of an element to its borders. +// * +// * Gradients tend to be tricky. There's no support for this property +// * in older IE, but "filter" comes to the rescue. It can generate +// * only horizontal and vertical gradients, though. Also IE9 has some +// * strange behaviour -> css3wizardry.com/2010/10/29/css-gradients-for-ie9/. +// * To provide the best experience for your visitors you should use +// * gradient generator (refer to resources above) with "IE9 Support" option checked. +// * +// * Resources: +// * -- gradient generator with broad browsers support and some advanced options: +// * -> www.colorzilla.com/gradient-editor/ +// * -- gradient is a powerful tool - you can generate shapes as a background! +// * -> lea.verou.me/css3patterns/ +// * +// * Browsers support: almost full +// * Notable lack of support: Opera mini +// * Caution! IE6 - IE8 use filter property that can generate only vertical and +// * horizontal gradients. For the best experience in IE9 use gradient generator +// * mentioned above in the resources. +// * +// * TODO: manual for .gradient(). Mention it's still compatible with previous versions of 3L since +// * you need to provide at least 4 values to use it. Anything less will use the old .gradient(). +// * You can provide as much stop colors as you want. +// */ + +// Multi-purpose gradient is in a BETA stage! Uncomment for your own responsibility. +///* +// * FIXME: you don't need to provide the @direction value since default is "to bottom". How to make it works? +// * FIXME: simple radial-gradient should work, but what if you provide some more advanced values? +// * FIXME: does it work with "to top left" and similar or angles? +// */ +// .gradient(@gradientType, @direction, @rest...) { + // @valuesProcessed: ~`"@{rest}".replace(/[\[\]]/g, '')`; + // @directionProcessedOld: ~`"@{direction}".replace(/[\[\]]|\,/g,'').replace("to ","").replace("top","bottom").replace("bottom","top").replace("right","left").replace("left","right").replace("at ","").replace("cover", "farthest-corner")`; + // @directionProcessedNew: ~`"@{direction}".replace(/[\[\]]|\,/g,'')`; +// + // @webkit1: `"-webkit-" + "@{gradientType}" + "-gradient(" + "@{directionProcessedOld}," + "@{valuesProcessed}" + ")"`; + // @webkit2: ~`'@{webkit1}'.replace(/\"/g, '')`; + // background-image: @webkit2; +// + // @moz1: `"-moz-" + "@{gradientType}" + "-gradient(" + "@{directionProcessedOld}," + "@{valuesProcessed}" + ")"`; + // @moz2: ~`'@{moz1}'.replace(/\"/g, '')`; + // background-image: @moz2; +// + // @o1: `"-o-" + "@{gradientType}" + "-gradient(" + "@{directionProcessedOld}," + "@{valuesProcessed}" + ")"`; + // @o2: ~`'@{o1}'.replace(/\"/g, '')`; + // background-image: @o2; +// + // @w3c1: `"@{gradientType}" + "-gradient(" + "@{directionProcessedNew}," + "@{valuesProcessed}" + ")"`; + // @w3c2: ~`'@{w3c1}'.replace(/\"/g, '')`; + // background-image: @w3c2; +// } + +.gradient (@color1, @color2){ + background: @color1; + background-image: -moz-linear-gradient(top, @color1 0%, @color2 100%); + background-image: -webkit-linear-gradient(top, @color1 0%,@color2 100%); + background-image: -o-linear-gradient(top, @color1 0%,@color2 100%); + background-image: linear-gradient(to bottom, @color1 0%,@color2 100%); + filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='@{color1}', endColorstr='@{color2}',GradientType=0 ); +} + + +.gradient (@color1, @color2, @color3){ + background: @color3; + background-image: -moz-linear-gradient(top, @color1 0%, @color2 100%); + background-image: -webkit-linear-gradient(top, @color1 0%,@color2 100%); + background-image: -o-linear-gradient(top, @color1 0%,@color2 100%); + background-image: linear-gradient(to bottom, @color1 0%,@color2 100%); + filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='@{color1}', endColorstr='@{color2}',GradientType=0 ); +} +// .vertical-gradient = .gradient +.vertical-gradient (@color1,@color2) {.gradient(@color1,@color2)} +.vertical-gradient (@color1,@color2,@color3) {.gradient(@color1,@color2,@color3)} +.horizontal-gradient (@color1, @color2) { + background: @color1; + background-image: -moz-linear-gradient(left, @color1 0%, @color2 100%); + background-image: -webkit-linear-gradient(left, @color1 0%,@color2 100%); + background-image: -o-linear-gradient(left, @color1 0%,@color2 100%); + background-image: linear-gradient(to right, @color1 0%,@color2 100%); + filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='@{color1}', endColorstr='@{color2}',GradientType=1 ); +} +.horizontal-gradient (@color1, @color2, @color3) { + background: @color3; + background-image: -moz-linear-gradient(left, @color1 0%, @color2 100%); + background-image: -webkit-linear-gradient(left, @color1 0%,@color2 100%); + background-image: -o-linear-gradient(left, @color1 0%,@color2 100%); + background-image: linear-gradient(to right, @color1 0%,@color2 100%); + filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='@{color1}', endColorstr='@{color2}',GradientType=1 ); +} +.diagonal-gradient (@color1, @color2) { + background: @color1; + background-image: -moz-linear-gradient(-45deg, @color1 0%, @color2 100%); + background-image: -webkit-linear-gradient(-45deg, @color1 0%,@color2 100%); + background-image: -o-linear-gradient(-45deg, @color1 0%,@color2 100%); + background-image: linear-gradient(135deg, @color1 0%,@color2 100%); + filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='@{color1}', endColorstr='@{color2}',GradientType=1 ); + } +.diagonal-gradient (@color1, @color2,@color3) { + background: @color3; + background-image: -moz-linear-gradient(-45deg, @color1 0%, @color2 100%); + background-image: -webkit-linear-gradient(-45deg, @color1 0%,@color2 100%); + background-image: -o-linear-gradient(-45deg, @color1 0%,@color2 100%); + background-image: linear-gradient(135deg, @color1 0%,@color2 100%); + filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='@{color1}', endColorstr='@{color2}',GradientType=1 ); + } +.radial-gradient (@color1, @color2) { + background: @color1; + background-image: -moz-radial-gradient(center, @color1 0%, @color2 100%); + background-image: -webkit-radial-gradient(center, @color1 0%,@color2 100%); + background-image: -o-radial-gradient(center, @color1 0%,@color2 100%); + background-image: radial-gradient(at center, @color1 0%,@color2 100%); + filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='@{color1}', endColorstr='@{color2}',GradientType=1 ); + } +.radial-gradient (@color1, @color2,@color3) { + background: @color3; + background-image: -moz-radial-gradient(center, @color1 0%, @color2 100%); + background-image: -webkit-radial-gradient(center, @color1 0%,@color2 100%); + background-image: -o-radial-gradient(center, @color1 0%,@color2 100%); + background-image: radial-gradient(at center, @color1 0%,@color2 100%); + filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='@{color1}', endColorstr='@{color2}',GradientType=1 ); + } + +///* +// * Background-size +// * Scale (or not) your background image. +// * +// * This property takes following values: +// * -- auto [default] - it does nothing when used alone; when used with a value +// * it makes sure that image will keep its aspect ratio while being stretched +// * to the required size. (See: examples 3. and 4.) +// * -- contain - scale image to the first border it meets; +// * it may leave some area uncovered but keeps image's aspect ratio, +// * -- cover - scale image to the second border it meets; +// * cover all area but part of an image may not be shown. The image keeps its aspect ratio. +// * -- px, em, % - scale image according to declared value; +// * you can declare one value (x-size) or two values for each size. +// * Using (100%, 100%) stretch the image to cover full area but may not +// * keep its aspect ratio. When you use percentages keep in mind that XX% +// * means XX% of the element size, not XX% of the background image. +// * +// * Consider adding background-repeat property to avoid unwanted repetition of background. +// * +// * Browsers support: IE9+, Fx3.6+, Chrome, Safari, Opera, Opera Mini, Opera Mobile, Android Browser +// * Notable lack of support: IE8- +// * +// * Examples: +// * 1. .background-size(contain); +// * 2. .background-size(cover); +// * 3. .background-size(70%); // = (70% auto). Image is scaled to take 70% of width +// * // of the element and it keeps its own aspect ratio. +// * 4. .background-size(auto, 70%) // Image is scaled to take 70% of element's +// * // height and keeps aspect ratio. +// * 5. background-size(70px 7em); // Size of the background image is now 70px (width) x 7em (height). +// * 6. background-size(70px,7em); // Same as above. Comma is fine too. +// * +// */ + +.background-size (...) { + -moz-background-size: @arguments; + background-size: @arguments; + } +// A shorthand class. +.bg-size (...) {.background-size(@arguments)} + +///* +// * Columns layout +// * +// * Divide a block of text into columns as seen in newspapers. +// * +// * Basic usage: +// * Use .columns() class providing in brackets arguments for columns. +// * Non of those arguments are required, but unless you provide one, columns +// * layout won't work. Available arguments: +// * -- integer - declare a column-count. Unless declared, their width will +// * equal to division of the block's width minus column-gaps and declared integer. +// * Default value is "auto" which means that width of columns will be determined +// * by column-width value. +// * -- width - declare every column width in px, em and % (of containing block). +// * Default value is "auto" - column width will be equal to division of the +// * block's width and declared column-count +// * +// * Usage of supporting classes: +// * You can declare the gaps between columns by .column-gap() class that takes +// * width type argument. Default value is "normal" and equals to 1em. +// * +// * Declare a vertical rule between columns using .column-rule(). It's the same +// * type of declaration as in borders, that is width, style and colour. By default +// * there is no rule. +// * +// * Browsers support: IE10+, Fx, Chrome, Safari, Opera, Opera Mobile, Android Browser +// * Notable lack of support: IE9-, Opera Mini +// * +// * Example: +// * 1. .column(2, 20px) // Two columns with 20px width. +// * 2. .column(5) // Five columns layout. +// * 3. element { +// * .column(100px); // A 100px width columns +// * .column-gap(10px); // with 10px gap between +// * .column-rule(1px solid black); // and 1px thick, solid, black vertical rule. +// * } +// * +// */ + +.columns (...) { + -webkit-columns: @arguments; + -moz-columns: @arguments; + columns: @arguments; + } +.column-gap (@gap) { + -webkit-column-gap: @gap; + -moz-column-gap: @gap; + column-gap: @gap; + } +.columns-gap (@gap) {.column-gap(@gap);} +.column-rule (...) { + -webkit-column-rule: @arguments; + -moz-column-rule: @arguments; + column-rule: @arguments; + } +.columns-rule (...) {.column-rule(@arguments);} +.column-fill (@fill) { + -webkit-column-fill: @fill; + -moz-column-fill: @fill; + column-fill: @fill; +} +.columns-fill (@fill) {.column-fill(@fill);} + +///* +// * Transform +// * 2D and 3D transformation of an object. +// * +// * You can use classes dedicated to specifics transformation, but if you plan +// * to use multiple transformation on an object, use general classes .transform +// * or .transform3d instead. Otherwise the latter transform will override the former. +// * If you want to use some of the 3D transformations, use .transform3d class. It +// * has a 3D specific property transform-style included. You can put both 3D and 2D +// * transformations in .transform3D. +// * +// * Transforms don't affect an object's place in a document and its environment +// * so there's no risk of crashing a layout. +// * +// * Transformations characteristics: +// * -- Rotate takes one argument and rotate object clockwise by specified angle (in deg). +// * -- Scale takes one or two arguments (x,y). If y is not specified it is assumed that x = y. +// * Arguments in interval (0,1) shrink the object. Arguments >1 makes it bigger. +// * -- Skew takes one or two arguments (x,y). If y is not specified it is assumed that y = 0 (no y-skew). +// * Arguments must be in deg. +// * -- Translate takes one or two arguments (w,y). If y is not specified it is assumed y = 0 (no y-translate). +// * Arguments are in px or em. Translate moves the object by specified value. +// * +// * Sometimes you might want to control the point that is the relative base of transformations. +// * For that reason use .transform-origin class. That class takes one or two values. +// * First value defines horizontal position of that point, second refers to vertical position. +// * In case you provide only the first value, the second is set to 50%. Default value is (50% 50%). +// * You can use three types of values: +// * -- pixels that place origin point in position according to the top-left corner of an element +// * to its bottom-right corner. Negative values allowed - in that case position goes to the left +// * and top from the top-left corner, +// * -- percentages that are relative to object's width and height. As in px, the original position +// * is top-left corner (0% 0%), and goes to bottom-right (100% 100%). Negative values does the +// * same as in px. +// * -- keywords: left / center / right for x-axis and top / center / bottom for y-axis. +// * +// * For 3D transformations you can set a perspective using .perspective() class and putting +// * value in brackets . +// * +// * Browsers support: IE9+, Fx3,5+, Chrome, Safari, Opera, Opera Mobile, Android Browser +// * Notable lack of support: IE8-*, Opera Mini +// * * You can use some of the transformation in older IE through filter property. +// * To generate that property refer to -> css3please.com. +// * You can also emulate scale property with zoom property. +// * +// * Examples: +// * 1. .scale(2,.5) // Stretch an object two times and shrink in height by half. +// * 2. .rotate(180deg) // Rotate an object by 180deg. +// * 3. .transform(.scale(2,.5),rotate(180deg)) // Does the combined transformation from examples above. +// * 4. .transform-origin(20% top) // Place the transformation origin at the top, 20% of the object's +// * // width to the right from the top-left corner. +// */ + +.transform-origin (...) { + -webkit-transform-origin: @arguments; + -moz-transform-origin: @arguments; + -ms-transform-origin: @arguments; + -o-transform-origin: @arguments; + transform-origin: @arguments; + } +.perspective (...) { + -webkit-perspective: @arguments; + -moz-perspective: @arguments; + -o-perspective: @arguments; + perspective: @arguments; + } +.backface-visibility(@visibility){ + -webkit-backface-visibility: @visibility; + backface-visibility: @visibility; +} +.transform (...) { + -webkit-transform: @arguments; + -moz-transform: @arguments; + -ms-transform: @arguments; + -o-transform: @arguments; + transform: @arguments; + } +.transform3d (...) { + -webkit-transform: @arguments; + -webkit-transform-style: preserve-3d; + -moz-transform: @arguments; + -moz-transform-style: preserve-3d; + -o-transform: @arguments; + -o-transform-style: preserve-3d; + transform: @arguments; + transform-style: preserve-3d; +} +.rotate (@rotate) { + -webkit-transform: rotate(@rotate); + -moz-transform: rotate(@rotate); + -ms-transform: rotate(@rotate); + -o-transform: rotate(@rotate); + transform: rotate(@rotate); + } +.rotate3d (@deg1, @deg2:0, @deg3:0){ + -webkit-transform: rotateX(@deg1) rotateY(@deg2) rotateZ(@deg3); + -webkit-transform-style: preserve-3d; + -moz-transform: rotateX(@deg1) rotateY(@deg2) rotateZ(@deg3); + -moz-transform-style: preserve-3d; + -o-transform: rotateX(@deg1) rotateY(@deg2) rotateZ(@deg3); + -o-transform-style: preserve-3d; + transform: rotateX(@deg1) rotateY(@deg2) rotateZ(@deg3); + transform-style: preserve-3d; + } +.scale (@scale) { + -webkit-transform: scale(@scale); + -moz-transform: scale(@scale); + -ms-transform: scale(@scale); + -o-transform: scale(@scale); + transform: scale(@scale); + } +.scale (@scale1,@scale2) { + -webkit-transform: scale(@scale1,@scale2); + -moz-transform: scale(@scale1,@scale2); + -ms-transform: scale(@scale1,@scale2); + -o-transform: scale(@scale1,@scale2); + transform: scale(@scale1,@scale2); + } +.scaleX (@scale) { + -webkit-transform: scaleX(@scale); + -moz-transform: scaleX(@scale); + -ms-transform: scaleX(@scale); + -o-transform: scaleX(@scale); + transform: scaleX(@scale); + } +.scaleY (@scale) { + -webkit-transform: scaleY(@scale); + -moz-transform: scaleY(@scale); + -ms-transform: scaleY(@scale); + -o-transform: scaleY(@scale); + transform: scaleY(@scale); + } +.skew (@skew) { + .skewX(@skew); + } +.skew (@skew1, @skew2) { + -webkit-transform: skewX(@skew1) skewY(@skew2); + -moz-transform: skewX(@skew1) skewY(@skew2); + -ms-transform: skewX(@skew1) skewY(@skew2); + -o-transform: skewX(@skew1) skewY(@skew2); + transform: skewX(@skew1) skewY(@skew2); + } +.skewX (@skew) { + -webkit-transform: skewX(@skew); + -moz-transform: skewX(@skew); + -ms-transform: skewX(@skew); + -o-transform: skewX(@skew); + transform: skewX(@skew); + } +.skewY (@skew) { + -webkit-transform: skewY(@skew); + -moz-transform: skewY(@skew); + -ms-transform: skewY(@skew); + -o-transform: skewY(@skew); + transform: skewY(@skew); + } +.translate (@translate) { + -webkit-transform: translate(@translate); + -moz-transform: translate(@translate); + -ms-transform: translate(@translate); + -o-transform: translate(@translate); + transform: translate(@translate); + } +.translate (@translate1, @translate2) { + -webkit-transform: translate(@translate1, @translate2); + -moz-transform: translate(@translate1, @translate2); + -ms-transform: translate(@translate1, @translate2); + -o-transform: translate(@translate1, @translate2); + transform: translate(@translate1, @translate2); + } +.translateX (@translate) { + -webkit-transform: translateX(@translate); + -moz-transform: translateX(@translate); + -ms-transform: translateX(@translate); + -o-transform: translateX(@translate); + transform: translateX(@translate); + } +.translateY (@translate) { + -webkit-transform: translateY(@translate); + -moz-transform: translateY(@translate); + -ms-transform: translateY(@translate); + -o-transform: translateY(@translate); + transform: translateY(@translate); + } + +///* +// * Transition +// * Animate a change between different object states. +// * +// * You can use this class to animate change of up to 5 different properties. +// * If you need more that that (wow!) it's easy to add more of these classes. +// * +// * Transition takes 4 values: +// * -- transition-property - choose a property you want to animate (margin, colour etc.). +// * Default value is "all" which will animate every change that might happen. It's a good +// * idea to explicitly write this value if you want to animate everything, though. We can't +// * be sure if in the future default state won't change to "none", which will break the whole transition. +// * -- transition-duration - specifies how long transition animation will have to take +// * until animation is finished. Put values in s (seconds) or ms (milliseconds). +// * Required value, since default state is 0s (no animation occurs). +// * -- transition-timing-function - this value describe an acceleration function. It can +// * really affect overall experience, so it's good idea to pay attention to that. +// * Timing function takes 4 number values of keywords: linear, ease, ease-in, +// * ease-in-out, ease-out. For further explanation refer to ->developer.mozilla.org/en/CSS/timing-function +// * Default value is "ease". +// * -- transition-delay - in seconds or millisecond describes how long transition will wait +// * until it occurs after a triggering requirement was met. Default value is 0 - instant animation. +// * +// * In case you want to put a transformation property into transition effect, use +// * the .transition-transform class. This class is prepared to automatically add +// * many browsers prefixes required in that case. It is also a bit future friendly, +// * but all at all using transitions on transform is very risky. +// * -> http://radiatingstar.com/transition-with-transform-cant-be-future-proof +// * +// * Usage: +// * For .transition class, put in brackets at least a time value. If you want to animate more than one +// * property or animate everything with different functions, put up to 5 declarations separated with +// * commas. If one of the property you want to animate is "transform" _and_ you want to animate every +// * other properties (or at least not with the same functions), use .transition-transform. As a first +// * value put a time duration for transform property. Do not write this property though. It's auto-added +// * for the first set of values. Add other properties after commas. Refer to the example 3. +// * +// * Browsers support: IE10+, Fx4+, Chrome, Opera, Safari, Opera Mobile, Android Browser +// * Notable lack of support: IE9-, Fx3.6-, Opera Mini +// * *** Transition provides only a visual effects between states. It's perfectly +// * *** safe to use. Users with older browser just won't see a phase of changing. +// * +// * Examples: +// * 1. .transition (all 1s); // Animate all properties for 1 second. +// * 2. .transition (background-color 5s, margin 1s linear 5s) // Animate change of background-color for 5s +// * // and after 5s animate margin change for 1s. +// * 3. .transition-transform (2s linear, padding 3s) // Animate change of transform property (no "transform" declared!) +// * // and padding property. +// * +// * Solution for multiple transitions in a single mixin taken from http://www.toekneestuck.com/blog/2012/05/15/less-css-arguments-variable/ +// */ + +.transition(@transition1, @transition2:X, ...){ + @transitions: ~`"@{arguments}".replace(/[\[\]]|\,\sX/g, '')`; + -webkit-transition: @transitions; + -moz-transition: @transitions; + -o-transition: @transitions; + transition: @transitions; +} +.transition-transform (@transformArguments1, @transformArguments2:X, ...) { + @transformArguments: ~`"@{arguments}".replace(/[\[\]]|\,\sX/g, '')`; + -webkit-transition: -webkit-transform @transformArguments; + -moz-transition: -moz-transform @transformArguments; + -o-transition: -o-transform @transformArguments; + transition: transform @transformArguments; +} +// FIXME: The specyfic properties also require the unlimited arguments feature. +.transition-property(...) { + -webkit-transition-property: @arguments; + -moz-transition-property: @arguments; + -o-transition-property: @arguments; + transition-property: @arguments; +} +.transition-duration(...) { + -webkit-transition-duration: @arguments; + -moz-transition-duration: @arguments; + -o-transition-duration: @arguments; + transition-duration: @arguments; +} +.transition-timing-function(...) { + -webkit-transition-timing-function: @arguments; + -moz-transition-timing-function: @arguments; + -o-transition-timing-function: @arguments; + transition-timing-function: @arguments; +} +.transition-delay(...) { + -webkit-transition-delay: @arguments; + -moz-transition-delay: @arguments; + -o-transition-delay: @arguments; + transition-delay: @arguments; +} + +///* +// * Animations +// * +// * Create an awesome animation! +// * +// * This class takes from two to five properties: +// * -- animation-name [required] - declare your @keyframes animation name. See below +// * for an easy way to make @keyframes! +// * -- animation-duration [required] - declare how long will it take for an animation +// * to reach end. Value in seconds (s) or milliseconds (ms). +// * -- timing-function - it's the same property as in transition. Refer to +// * that topic for further explanation. +// * -- iteration-count - how many times an animation will repeat. It takes integer +// * or "infinite" keyword (for infinite repetition). Default value is 1. +// * -- direction - indicates whether the animation should play in reverse on +// * alternate cycles. Refer to ->developer.mozilla.org/en/CSS/animation-direction +// * for better explanation. To declare a direction use normal [default value], +// * alternate, reverse or alternate-reverse keyword. +// * +// * Resources: +// * -- developer.mozilla.org/en/CSS/animation +// * +// * Creating @keyframes: +// * Write in your .less file: +// * *** @import 'animationX.less'; +// * where X stands for a number between 1 and 5. Then create a class +// * *** .animationX () {} +// * and in {} write declarations you normally write in @keyframes. +// * Then just put an .animation(animationX [other animation properties]) class in your element. +// * That's all! +// * +// * Example: +// * .toBeAnimated { +// * // Animation with every possible value declared. // +// * .animation(animation1 5s linear 3s infinite alternate); +// * } +// * // Importing prefixed @keyframes for animation1. +// * @import '3L/assets/animations/animation1'; +// * +// * // Declaring @keyframes for animation. Only once! +// * .animation1() { +// * from {margin-top: 3px;} +// * to {margin-top: 333px;} +// * } +// * +// */ + +.animation (...) { + -webkit-animation: @arguments; + -moz-animation: @arguments; + -o-animation: @arguments; + animation: @arguments; + } +.animate (...) {.animation(@arguments);} +.anime (...) {.animation(@arguments);} +// FIXME: The specyfic properties also require the unlimited arguments feature. +.animation-name(...) { + -webkit-animation-name: @arguments; + -moz-animation-name: @arguments; + -o-animation-name: @arguments; + animation-name: @arguments; +} +.animation-duration(...) { + -webkit-animation-duration: @arguments; + -moz-animation-duration: @arguments; + -o-animation-duration: @arguments; + animation-duration: @arguments; +} +.animation-timing-function(...) { + -webkit-animation-timing-function: @arguments; + -moz-animation-timing-function: @arguments; + -o-animation-timing-function: @arguments; + animation-timing-function: @arguments; +} +.animation-delay(...) { + -webkit-animation-delay: @arguments; + -moz-animation-delay: @arguments; + -o-animation-delay: @arguments; + animation-delay: @arguments; +} +.animation-iteration-count(...) { + -webkit-animation-iteration-count: @arguments; + -moz-animation-iteration-count: @arguments; + -o-animation-iteration-count: @arguments; + animation-iteration-count: @arguments; +} +.animation-direction(...) { + -webkit-animation-direction: @arguments; + -moz-animation-direction: @arguments; + -o-animation-direction: @arguments; + animation-direction: @arguments; +} +.animation-fill-mode(...) { + -webkit-animation-fill-mode: @arguments; + -moz-animation-fill-mode: @arguments; + -o-animation-fill-mode: @arguments; + animation-fill-mode: @arguments; +} + +///* +// * User-select +// * controls the selection model and granularity of an element. +// * +// * This property takes following values: +// * -- none - none of the element's content can be selected. +// * -- text [default] - the element's contents follow a standard text content selection model. +// * -- toggle - the element's contents follow a standard toggling content model. +// * -- element - one element at a time may be selected. +// * -- elements - one or more elements at a time may be selected. +// * -- all - Only the entire contents as a whole can be selected. +// * +// * Browsers support: IE10+, Fx0.6+, Chrome, Safari +// * Notable lack of support: IE9-, Opera +// * +// */ + +.user-select (...) { +-webkit-touch-callout: @arguments; +-webkit-user-select: @arguments; +-khtml-user-select: @arguments; +-moz-user-select: @arguments; +-ms-user-select: @arguments; +user-select: @arguments; +} + +///* +// * Filter +// * +// * Advanced image manipulation in your CSS! +// * +// * Note: the filter property works only in Webkit for now. Will the prefixed version for other +// * vendors be supported, is unknown, so the mixin might for now generate useles code. +// * You might want to use just the -webkit-filter property without the help of .filter() mixin. +// * +// * drop-shadow and opacity might be hardware accelerated. +// * +// * Resources: http://www.html5rocks.com/en/tutorials/filters/understanding-css/ +// * +// * TODO: requires testing +// */ +// FIXME: .filter() requires the unlimited arguments feature. +.filter(...) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.grayscale(@amount) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.sepia(@amount) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.saturate(@amount) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.hue-rotation(@angle) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.invert(@amount) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +// .opacity() already taken, hence the -filter suffix. +.opacity-filter(@amount) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.brightness(@amount) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.contrast(@amount) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.blur(@radius) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.drop-shadow(@shadow) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.url(@url) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} + +///* +// * Border image +// * +// * Browsers support: Chrome, Firefox, Safari, Opera, Chrome for Android, Android Browser, Opera Mobile, Firefox for Android +// * Notable lack of support: IE, Opera Mini +// */ +.border-image(@url, @rest...) { + -webkit-border-image:url(@url) @rest; + -o-border-image:url(@url) @rest; + border-image:url(@url) @rest; +} + +///* +// * Flexible Box Model +// * +// * Resources: https://developer.mozilla.org/en-US/docs/CSS/Using_CSS_flexible_boxes +// * +// * Browsers Support: Chrome, Firefox 18*, Opera 12.1, Opera Mini 12.1 +// * Notable lack of support: IE, Firefox 17 (stable), Safari, Chrome for Android +// */ + +.display-flex() { + display: -webkit-flex; + display: -moz-flex; + display: flex; +} +.display-inline-flex(){ + display: -webkit-inline-flex; + display: -moz-inline-flex; + display: inline-flex; +} +.flex-direction(@direction) { + -webkit-flex-direction: @direction; + -moz-flex-direction: @direction; + flex-direction: @direction; +} +.justify-content(@alignment) { + -webkit-justify-content: @alignment; + -moz-justify-content: @alignment; + justify-content: @alignment; +} +.align-content(@alignment) { + -webkit-align-content: @alignment; + -moz-align-content: @alignment; + align-content: @alignment; +} +.align-items(@alignment) { + -webkit-align-items: @alignment; + -moz-align-items: @alignment; + align-items: @alignment; +} +.align-self(@alignment) { + -webkit-align-self: @alignment; + -moz-align-self: @alignment; + align-self: @alignment; +} +.flex(@arguments){ + -webkit-flex: @arguments; + -moz-flex: @arguments; + flex: @arguments; +} +.flex-basis(@basis) { + -webkit-flex-basis: @basis; + -moz-fles-basis: @basis; + flex-basis: @basis; +} +.flex-grow(@grow) { + -webkit-flex-grow: @grow; + -moz-flex-grow: @grow; + flex-grow: @grow; +} +.flex-shrink(@shrink) { + -webkit-flex-shrink: @shrink; + -moz-flex-shrink: @shrink; + flex-shrink: @shrink; +} +.flex-flow(@arguments) { + -webkit-flex-flow: @arguments; + -moz-flex-flow: @arguments; + flex-flow: @arguments; +} +.flex-direction(@direction) { + -webkit-flex-direction: @direction; + -moz-flex-direction: @direction; + flex-direction: @direction; +} +.flex-wrap(@wrap) { + -webkit-flex-wrap: @wrap; + -moz-flex-wrap: @wrap; + flex-wrap: @wrap; +} +.order(@order) { + -webkit-order: @order; + -moz-order: @order; + order: @order; +} + +///* +// * Appearance +// */ + +.appearance (@appearance) { + -webkit-appearance: @appearance; + -moz-appearance: @appearance; +} + +///* +// * Selection +// * +// * You can use it on the root of your CSS or inside a specyfic element. +// * +// * Examples: +// * 1. .selection(red, blue); +// * 2. p{ +// * .selection(red, blue) +// * } +// */ + +.selection(@text-color, @background-color) { + &::-moz-selection {color: @text-color; background-color: @background-color;} + &::selection {color: @text-color; background-color: @background-color;} +} + +///* +// * hasLayout +// * +// * http://reference.sitepoint.com/css/haslayout +// */ + +.hasLayout() {*zoom: 1;} + +///* +// * Normalize +// */ + +.normalize(){article,aside,details,figcaption,figure,footer,header,hgroup,nav,section,summary{display:block}audio,canvas,video{display:inline-block}audio:not([controls]){display:none;height:0}[hidden]{display:none}html{font-family:sans-serif;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}body{margin:0}a:focus{outline:thin dotted}a:active,a:hover{outline:0}h1{font-size:2em}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:bold}dfn{font-style:italic}mark{background:#ff0;color:#000}code,kbd,pre,samp{font-family:monospace,serif;font-size:1em}pre{white-space:pre;white-space:pre-wrap;word-wrap:break-word}q{quotes:"\201C" "\201D" "\2018" "\2019"}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sup{top:-0.5em}sub{bottom:-0.25em}img{border:0}svg:not(:root){overflow:hidden}figure{margin:0}fieldset{border:1px solid #c0c0c0;margin:0 2px;padding:.35em .625em .75em}legend{border:0;padding:0}button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}button,input{line-height:normal}button,html input[type="button"],input[type="reset"],input[type="submit"]{-webkit-appearance:button;cursor:pointer}button[disabled],input[disabled]{cursor:default}input[type="checkbox"],input[type="radio"]{box-sizing:border-box;padding:0}input[type="search"]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}input[type="search"]::-webkit-search-cancel-button,input[type="search"]::-webkit-search-decoration{-webkit-appearance:none}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}textarea{overflow:auto;vertical-align:top}table{border-collapse:collapse;border-spacing:0}} + +///* +// * Reset +// */ + +.reset() {html,body,div,span,applet,object,iframe,h1,h2,h3,h4,h5,h6,p,blockquote,pre,a,abbr,acronym,address,big,cite,code,del,dfn,em,img,ins,kbd,q,s,samp,small,strike,strong,sub,sup,tt,var,b,u,i,center,dl,dt,dd,ol,ul,li,fieldset,form,label,legend,table,caption,tbody,tfoot,thead,tr,th,td,article,aside,canvas,details,embed,figure,figcaption,footer,header,hgroup,menu,nav,output,ruby,section,summary,time,mark,audio,video{margin:0;padding:0;border:0;font-size:100%;font:inherit;vertical-align:baseline}article,aside,details,figcaption,figure,footer,header,hgroup,menu,nav,section{display:block}body{line-height:1}ol,ul{list-style:none}blockquote,q{quotes:none}blockquote:before,blockquote:after,q:before,q:after{content:'';content:none}table{border-collapse:collapse;border-spacing:0}} + +///* +// * HTML5 Boiler Plate's default stylesheets. +// */ +.h5bp() {html,button,input,select,textarea{color:#222}body{font-size:1em;line-height:1.4}::-moz-selection{background:#b3d4fc;text-shadow:none}::selection{background:#b3d4fc;text-shadow:none}hr{display:block;height:1px;border:0;border-top:1px solid #ccc;margin:1em 0;padding:0}img{vertical-align:middle}fieldset{border:0;margin:0;padding:0}textarea{resize:vertical}.chromeframe{margin:.2em 0;background:#ccc;color:#000;padding:.2em 0}} +.h5bp-print() {@media print{*{background:transparent !important;color:#000 !important;box-shadow:none !important;text-shadow:none !important;} a,a:visited{text-decoration:underline;} a[href]:after{content:" (" attr(href) ")";} abbr[title]:after{content:" (" attr(title) ")";} .ir a:after,a[href^="javascript:"]:after,a[href^="#"]:after{content:"";} pre,blockquote{border:1px solid #999;page-break-inside:avoid;} thead{display:table-header-group;} tr,img{page-break-inside:avoid;} img{max-width:100% !important;} @page {margin:0.5cm;}p,h2,h3{orphans:3;widows:3;} h2,h3{page-break-after:avoid;}}.przerwa{color:#ff0000;}} + + +.ninja() { + color: black; + visibility: hidden; +} + diff --git a/docs/_build/html/_static/less/docs.less b/docs/_build/html/_static/less/docs.less new file mode 100644 index 00000000..3eaa34b3 --- /dev/null +++ b/docs/_build/html/_static/less/docs.less @@ -0,0 +1,287 @@ +body + { + font-family: "Open Sans", "Helvetica Neue", sans-serif; + font-weight: 300; + color: #333; + background: @white; + } +body:not(.landing) + { + padding:0px 20px; + padding-top: 40px; + h2 + { + margin-top: 40px; + } + } +input + { + background: transparent; + border: 1px solid #999; + .border-radius(3px); + padding: 2px 5px; + color: #666; + font-family: "Open Sans"; + font-weight: 300; + outline: none; + &:focus + { + background: white; + } + } +div.related + { + background: rgba(255,200,200,.2); + } + +* > a.headerlink + { + display: none; + } + +h1, h2, h3, h4, h5, h6 + { + font-weight: 300; + } + +a:link, a:visited + { + color: @orange; + text-decoration: none; + } +a:hover, a:active + { + text-decoration: underline; + color: lighten(@orange, 10); + } + +.literal + { + color: @purple; + font-size: 1em; + background: lighten(@purple-light, 45); + padding: 1px 2px; + .border-radius(2px); + .box-shadow(inset 0px 0px 0px 1px lighten(@purple-light, 30)); + } + +.note + { + .gradient(lighten(@purple-light, 10), lighten(@purple-light-shade, 10)); + .border-radius(5px); + .box-shadow(0px 2px 3px @purple-shade); + padding: 10px 20px 10px 70px; + position: relative; + color: white; + .admonition-title {display: none;} + a { color: lighten(@orange, 30);} + &:before + { + content: ""; + display: block; + .icon; + .icon.info; + position: absolute; + margin: auto; + top: 0; bottom: 0; left: 20px; + } + .literal, .highlight-note + { + color: white; + background: darken(@purple-light, 3); + padding: 1px 3px; + .border-radius(2px); + .box-shadow(inset 0px 0px 0px 1px lighten(@purple-light, 10)); + } + .highlight-note + { + padding: 1px 10px; + pre:before + { + content: "$ "; + color: @orange; + } + } + } + +.highlight + { + background:transparent !important; + } +.highlight-output + { + .pre-block; + background: desaturate(lighten(@terminal,10), 10); + } +.highlight-javascript + { + .pre-block; + background: desaturate(lighten(@terminal,10), 10); + } +.highlight-python + { + .terminal; + pre + { + margin: 0 0 10px 0; + &:before + { + content: "$ "; + color: @orange; + } + } + } + +*:hover > a.headerlink + { + display: inline; + color: lighten(@purple-light, 30); + margin-left: 10px; + text-decoration: none; + &:hover { color: @purple-light; } + } + +tt + { + color: @purple; + font-size: 1.2em; + } +ul li { + margin-bottom: 10px; +} + +div.document + { + max-width: 900px; + margin: 20px auto; + position: relative; + } +div.documentwrapper + { + margin-left: 240px; + padding: 0; + } +aside + { + position: absolute; + width: 220px; + top: 0px; + .logo + { + margin: 0 auto 20px auto; + display: block; + width: 90px; + height: 98px; + } + color: #999; + h2, h3, h3 a:link, h3 a:visited + { + color: #777; + } + + a:link, a:visited + { + color: #999; + } + a:hover, a:active + { + color: @orange; + } + input[type=submit] + { + display: none; + } + &>ul + { + margin: 0 4px; + padding: 0; + list-style: none; + &>li + { + margin-bottom: 10px; + font-size: 18px; + color: #777; + a:link, a:visited {color: #777;} + ul + { + margin: 10px 0 0 0; + padding-left: 20px; + font-size: 16px; + color: #999; + a:link, a:visited {color: #999;} + } + } + } + } + +div.footer + { + font-size: .8em; + text-align: center; + margin: 40px 0; + color: #999; + a:link, a:visited {color: #555;} + } + +@media screen and (max-width: 820px) + { + body:not(.landing){ + padding-top: 130px; + .highlight-output,.highlight-python, .highlight-javascript + { + width: auto; + max-width: 500px; + } + .highlight-python + { + pre { margin: -10px 0 10px 0;} + &:before + { + height: 24px !important; + line-height: 24px; + font-size: .7em; + } + &:after + { + background: none; + } + } + aside + { + position: static; + } + div.documentwrapper + { + margin: 0px; + } + h1, .section + { + margin: 0px !important; + } + aside + { + background-color: #f0f0f0; + width: 100%; + margin: 5px -20px; + padding: 5px 20px 10px 20px; + } + #logolink + { + position: absolute; + top: -120px; + left: 50%; + margin-left: -49px; + } + } + + } +@media (-webkit-min-device-pixel-ratio: 1.5), (min--moz-device-pixel-ratio: 1.5), (-o-min-device-pixel-ratio: 3/2), (min-resolution: 1.5dppx) + { + aside .logo, body#landing #upper #logo + { + width: 90px; + height: 98px; + content: url(../img/logo@2x.png); + } + + } diff --git a/docs/_build/html/_static/less/jrnl.less b/docs/_build/html/_static/less/jrnl.less new file mode 100644 index 00000000..ce597b49 --- /dev/null +++ b/docs/_build/html/_static/less/jrnl.less @@ -0,0 +1,317 @@ +@import "retina"; +@import "3L"; + +@white: #f7f8f9; +@blue: #5e7dc5; +@blue-light: #7c95ca; +@terminal: #2f1e34; +@purple: #47375d; +@purple-shade: #413155; +@purple-light: #725794; +@purple-light-shade: #564371; +@orange: #deaa09; + +.normalize(); +@import "docs.less"; + +.icon, + { + .sprite("../img/icons.png", 32px, 5, 3, 8px); + &.secure {.sprite(0, 0)}; + &.future {.sprite(1, 0)}; + &.search {.sprite(2, 0)}; + &.nli {.sprite(3, 0)}; + &.share {.sprite(0, 1)}; + &.sync {.sprite(0, 1)}; + &.dayone {.sprite(1, 1)}; + &.github {.sprite(2, 1)}; + &.folders{.sprite(3, 1)}; + &.cal {.sprite(4, 1)}; + &.left {.sprite(0, 2)}; + &.right {.sprite(1, 2)}; + &.info {.sprite(2, 2)}; + } + +.pre-block + { + background: @terminal; + .border-radius(6px); + padding: 1px 20px; + margin: 40px auto; + width: 500px; + .box-shadow(0px 1px 8px darken(@white, 30)); + position: relative; + color: @white; + font-family: "Monaco", "Courier New"; + font-size: 12pt; + #args {color: #f6f7b9} + #output {color: #9278b5} + } + +.terminal + { + .pre-block; + @p: 20px; + padding: @p + 30px @p (@p - 10px) @p; + &:before + { + content: "Terminal"; + display: block; + width: 100%; + position: absolute; + left: 0; + .box-shadow(inset 0px 1px 0px #f4f4f4, inset 0px -1px 0px #888); + margin-top: -50px; + // margin: -@p -@p 0px -@p; + text-align: center; + height: 30px; + line-height: 30px; + color: #777; + text-shadow: 0px 1px 0px #ddd; + .border-radius(5px 5px 0px 0px); + .gradient(#eaeaea, #bababa); + } + &:after + { + content: ""; + width: 48px; + height: 30px; + position: absolute; + top: 0px; + left: 10px; + background: url(../img/terminal.png) no-repeat center center; + } + } + +body#landing + { + background-color: @purple; + font-family: "Open Sans", "Helvetica Neue", sans-serif; + font-weight: 300; + #twitter + { + display: block; + position: absolute; + top: 20px; + right: 20px; + border: 1px solid @purple; + padding: 5px 10px 5px 30px; + color: @purple; + .border-radius(3px); + .opacity(.7); + background: url(../img/twitter.png) 8px center no-repeat transparent; + &:hover, &:active + { + .opacity(1); + text-decoration: none; + } + } + #title, .row3, .row4, #prompt + { + width: 900px; + margin: 0px auto; + } + #upper + { + .clearfix; + background: @white; + .box-shadow(inset 0px -6px 6px -3px darken(@white, 10)); + #title + { + width: 650px; + margin: 150px auto 75px auto; + } + img + { + float: left; + margin-right: 30px; + } + h1 + { + color: @purple-light-shade; + font-weight: 300; + } + #prompt + { + width: 640px; + margin: 0 auto; + .clearfix; + } + .terminal + { + .border-radius(6px 6px 0px 0px); + float: left; + margin: 0px; + width: 500px; + min-height: 134px; + .border-box-sizing; + } + .pleft, .pright + { + text-align: center; + .border-box-sizing; + float: left; + padding-top: 50px; + width: 70px; + i {.opacity(60);} + i:hover {.opacity(1000); cursor: pointer;} + } + } + #nav + { + .gradient(@blue-light, @blue); + height: 60px; + .box-shadow(0px 6px 6px -3px @purple-shade); + text-align: center; + a#twitter-nav {display: none;} + a + { + color: @white; + text-shadow: 0px -1px 0px darken(@blue, 30); + text-decoration: none; + font-size: 14pt; + line-height: 60px; + margin: 0 40px; + &:hover + { + color: lighten(@orange, 20); + text-shadow: 0px -1px 0px darken(@orange, 15); + } + } + a.cta + { + .gradient(@purple-light, @purple-light-shade); + .box-shadow(0px 1px 0px @purple-shade); + .border-radius(5px); + padding: 6px 10px 5px 10px; + white-space: nowrap; + &:hover + { + .gradient(lighten(@orange, 10), darken(@orange, 5)); + .box-shadow(0px 1px 0px darken(@orange, 15)); + text-shadow: 0px -1px 0px darken(@orange, 15); + color: @white; + + } + } + } + #lower + { + color: @white; + padding-top: 40px; + a + { + color: @orange; + text-decoration: none; + &:hover + { + color: lighten(@orange, 20); + text-decoration: underline; + } + } + .row3, .row4 { + .clearfix; + margin-bottom: 20px; + .col + { + position: relative; + padding-left: 40px; + i + { + position: absolute; + left: 0; + top: 16px; + } + h3 {font-size: 12pt; margin-bottom: .5em;} + p {font-size: 10pt; margin: 0;} + float: left; + width: 25%; + padding-right: 2%; + .border-box-sizing; + &:last-child {padding-right: 0;} + } + } + .row3 .col { width: 33.3333%; } + .row4 .col { color: mix(@white, @purple, 80); i {.opacity(80);}} + } + } + +@media screen and (max-width: 680px) + { + body#landing + { + #nav + { + height: auto; + padding-bottom: 10px; + a, a#twitter-nav + { + display: block; + } + a.cta + { + margin: 10px; + padding: 1px; + } + } + #upper + { + #twitter { display: none;} + #title + { + margin: 30px 0 10px 0; + } + #logo + { + backgound: red; + display: block; + float: none; + margin: 0px auto; + } + #title br {display: none;} + .pleft, .pright {display: none;} + #prompt, #title + { + width: 100%; + .border-box-sizing; + padding: 0px 20px; + } + .terminal + { + width: 100%; + } + } + } + } + +@media screen and (max-width: 900px) + { + body#landing + { + #lower + { + padding: 40px 20px; + .row3, .row4 + { + margin: 0px; + width: auto; + } + .row3 .col, .row4 .col + { + float: none; + width: 100%; + text-align: center; + padding: 0px; + margin: 0 0 40px 0; + h3 {font-size: 1.5em;} + p {font-size: 1em;} + + i + { + position: static; + margin-bottom: -20px; + } + } + } + } + } diff --git a/docs/_build/html/_static/less/retina.less b/docs/_build/html/_static/less/retina.less new file mode 100644 index 00000000..3c006c45 --- /dev/null +++ b/docs/_build/html/_static/less/retina.less @@ -0,0 +1,35 @@ +// A helper mixin for applying high-resolution background images (http://www.retinajs.com) + +@highdpi: ~"(-webkit-min-device-pixel-ratio: 1.5), (min--moz-device-pixel-ratio: 1.5), (-o-min-device-pixel-ratio: 3/2), (min-resolution: 1.5dppx)"; + +.at2x(@path, @w: auto, @h: auto) { + background-image: url(@path); + @at2x_path: ~`@{path}.replace(/\.\w+$/, function(match) { return "@2x" + match; })`; + background-size: @w @h; + + @media @highdpi { + background-image: url("@{at2x_path}"); + } +} + +// Sprite mixin, see https://coderwall.com/p/oztebw + +.sprite (@path, @size, @w, @h, @pad: 0) when (isstring(@path)) + { + background-image: url(@path); + width: @size; + height: @size; + display: inline-block; + @at2x_path: ~`@{path}.replace(/\.[\w\?=]+$/, function(match) { return "@2x" + match; })`; + font-size: @size + @pad; + background-size: (@size + @pad) * @w (@size + @pad) * @h; + @media @highdpi + { + background-image: url("@{at2x_path}"); + } + } + +.sprite(@x, @y) + { + background-position: -@x * 1em -@y * 1em; + } diff --git a/docs/_build/html/_static/minus.png b/docs/_build/html/_static/minus.png new file mode 100644 index 0000000000000000000000000000000000000000..da1c5620d10c047525a467a425abe9ff5269cfc2 GIT binary patch literal 199 zcmeAS@N?(olHy`uVBq!ia0vp^+#t-s1SHkYJtzcHoCO|{#XvD(5N2eUHAey{$X?>< z>&kweokM_|(Po{+Q=kw>iEBiObAE1aYF-J$w=>iB1I2<oT^vIsE+^X*KjUGJJ8<a0 zfdz{eHHE&rzrX(bySvGUL|lavlN4AuRwpzDOq(`sMv;5Joa+jUx<3|oWPN;mPUJ0` pW__Wi<5+59Lc)&n_i}Q^3>R$WLpMkF=>bh=@O1TaS?83{1OVknK<NMg literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/plus.png b/docs/_build/html/_static/plus.png new file mode 100644 index 0000000000000000000000000000000000000000..b3cb37425ea68b39ffa7b2e5fb69161275a87541 GIT binary patch literal 199 zcmeAS@N?(olHy`uVBq!ia0vp^+#t-s1SHkYJtzcHoCO|{#XvD(5N2eUHAey{$X?>< z>&kweokM`jkU7Va11Q8%;u=xnoS&PUnpeW`?aZ|OK(QcC7sn8Z%gHvy&v=;Q4jejg zV8NnAO`-4Z@2~&<?ryS^@YXF`T!a&o6j(S`Cmb}9IcHb(MZ@Xn$H&JXUMl#uzyAM< o7knL=1-mEi3=josIGoJJAh%tCVFz!`HlXPYp00i_>zopr02WF_WB>pF literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/pygments.css b/docs/_build/html/_static/pygments.css new file mode 100644 index 00000000..f62f9ecb --- /dev/null +++ b/docs/_build/html/_static/pygments.css @@ -0,0 +1,70 @@ +.highlight .hll { background-color: #404040 } +.highlight { background: #202020; color: #d0d0d0 } +.highlight .c { color: #999999; font-style: italic } /* Comment */ +.highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */ +.highlight .g { color: #d0d0d0 } /* Generic */ +.highlight .k { color: #6ab825; font-weight: bold } /* Keyword */ +.highlight .l { color: #d0d0d0 } /* Literal */ +.highlight .n { color: #d0d0d0 } /* Name */ +.highlight .o { color: #d0d0d0 } /* Operator */ +.highlight .x { color: #d0d0d0 } /* Other */ +.highlight .p { color: #d0d0d0 } /* Punctuation */ +.highlight .cm { color: #999999; font-style: italic } /* Comment.Multiline */ +.highlight .cp { color: #cd2828; font-weight: bold } /* Comment.Preproc */ +.highlight .c1 { color: #999999; font-style: italic } /* Comment.Single */ +.highlight .cs { color: #e50808; font-weight: bold; background-color: #520000 } /* Comment.Special */ +.highlight .gd { color: #d22323 } /* Generic.Deleted */ +.highlight .ge { color: #d0d0d0; font-style: italic } /* Generic.Emph */ +.highlight .gr { color: #d22323 } /* Generic.Error */ +.highlight .gh { color: #ffffff; font-weight: bold } /* Generic.Heading */ +.highlight .gi { color: #589819 } /* Generic.Inserted */ +.highlight .go { color: #cccccc } /* Generic.Output */ +.highlight .gp { color: #aaaaaa } /* Generic.Prompt */ +.highlight .gs { color: #d0d0d0; font-weight: bold } /* Generic.Strong */ +.highlight .gu { color: #ffffff; text-decoration: underline } /* Generic.Subheading */ +.highlight .gt { color: #d22323 } /* Generic.Traceback */ +.highlight .kc { color: #6ab825; font-weight: bold } /* Keyword.Constant */ +.highlight .kd { color: #6ab825; font-weight: bold } /* Keyword.Declaration */ +.highlight .kn { color: #6ab825; font-weight: bold } /* Keyword.Namespace */ +.highlight .kp { color: #6ab825 } /* Keyword.Pseudo */ +.highlight .kr { color: #6ab825; font-weight: bold } /* Keyword.Reserved */ +.highlight .kt { color: #6ab825; font-weight: bold } /* Keyword.Type */ +.highlight .ld { color: #d0d0d0 } /* Literal.Date */ +.highlight .m { color: #3677a9 } /* Literal.Number */ +.highlight .s { color: #ed9d13 } /* Literal.String */ +.highlight .na { color: #bbbbbb } /* Name.Attribute */ +.highlight .nb { color: #24909d } /* Name.Builtin */ +.highlight .nc { color: #447fcf; text-decoration: underline } /* Name.Class */ +.highlight .no { color: #40ffff } /* Name.Constant */ +.highlight .nd { color: #ffa500 } /* Name.Decorator */ +.highlight .ni { color: #d0d0d0 } /* Name.Entity */ +.highlight .ne { color: #bbbbbb } /* Name.Exception */ +.highlight .nf { color: #447fcf } /* Name.Function */ +.highlight .nl { color: #d0d0d0 } /* Name.Label */ +.highlight .nn { color: #447fcf; text-decoration: underline } /* Name.Namespace */ +.highlight .nx { color: #d0d0d0 } /* Name.Other */ +.highlight .py { color: #d0d0d0 } /* Name.Property */ +.highlight .nt { color: #6ab825; font-weight: bold } /* Name.Tag */ +.highlight .nv { color: #40ffff } /* Name.Variable */ +.highlight .ow { color: #6ab825; font-weight: bold } /* Operator.Word */ +.highlight .w { color: #666666 } /* Text.Whitespace */ +.highlight .mf { color: #3677a9 } /* Literal.Number.Float */ +.highlight .mh { color: #3677a9 } /* Literal.Number.Hex */ +.highlight .mi { color: #3677a9 } /* Literal.Number.Integer */ +.highlight .mo { color: #3677a9 } /* Literal.Number.Oct */ +.highlight .sb { color: #ed9d13 } /* Literal.String.Backtick */ +.highlight .sc { color: #ed9d13 } /* Literal.String.Char */ +.highlight .sd { color: #ed9d13 } /* Literal.String.Doc */ +.highlight .s2 { color: #ed9d13 } /* Literal.String.Double */ +.highlight .se { color: #ed9d13 } /* Literal.String.Escape */ +.highlight .sh { color: #ed9d13 } /* Literal.String.Heredoc */ +.highlight .si { color: #ed9d13 } /* Literal.String.Interpol */ +.highlight .sx { color: #ffa500 } /* Literal.String.Other */ +.highlight .sr { color: #ed9d13 } /* Literal.String.Regex */ +.highlight .s1 { color: #ed9d13 } /* Literal.String.Single */ +.highlight .ss { color: #ed9d13 } /* Literal.String.Symbol */ +.highlight .bp { color: #24909d } /* Name.Builtin.Pseudo */ +.highlight .vc { color: #40ffff } /* Name.Variable.Class */ +.highlight .vg { color: #40ffff } /* Name.Variable.Global */ +.highlight .vi { color: #40ffff } /* Name.Variable.Instance */ +.highlight .il { color: #3677a9 } /* Literal.Number.Integer.Long */ \ No newline at end of file diff --git a/docs/_build/html/_static/searchtools.js b/docs/_build/html/_static/searchtools.js new file mode 100644 index 00000000..663be4c9 --- /dev/null +++ b/docs/_build/html/_static/searchtools.js @@ -0,0 +1,560 @@ +/* + * searchtools.js_t + * ~~~~~~~~~~~~~~~~ + * + * Sphinx JavaScript utilties for the full-text search. + * + * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +/** + * helper function to return a node containing the + * search summary for a given text. keywords is a list + * of stemmed words, hlwords is the list of normal, unstemmed + * words. the first one is used to find the occurance, the + * latter for highlighting it. + */ + +jQuery.makeSearchSummary = function(text, keywords, hlwords) { + var textLower = text.toLowerCase(); + var start = 0; + $.each(keywords, function() { + var i = textLower.indexOf(this.toLowerCase()); + if (i > -1) + start = i; + }); + start = Math.max(start - 120, 0); + var excerpt = ((start > 0) ? '...' : '') + + $.trim(text.substr(start, 240)) + + ((start + 240 - text.length) ? '...' : ''); + var rv = $('<div class="context"></div>').text(excerpt); + $.each(hlwords, function() { + rv = rv.highlightText(this, 'highlighted'); + }); + return rv; +} + + +/** + * Porter Stemmer + */ +var Stemmer = function() { + + var step2list = { + ational: 'ate', + tional: 'tion', + enci: 'ence', + anci: 'ance', + izer: 'ize', + bli: 'ble', + alli: 'al', + entli: 'ent', + eli: 'e', + ousli: 'ous', + ization: 'ize', + ation: 'ate', + ator: 'ate', + alism: 'al', + iveness: 'ive', + fulness: 'ful', + ousness: 'ous', + aliti: 'al', + iviti: 'ive', + biliti: 'ble', + logi: 'log' + }; + + var step3list = { + icate: 'ic', + ative: '', + alize: 'al', + iciti: 'ic', + ical: 'ic', + ful: '', + ness: '' + }; + + var c = "[^aeiou]"; // consonant + var v = "[aeiouy]"; // vowel + var C = c + "[^aeiouy]*"; // consonant sequence + var V = v + "[aeiou]*"; // vowel sequence + + var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 + var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 + var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 + var s_v = "^(" + C + ")?" + v; // vowel in stem + + this.stemWord = function (w) { + var stem; + var suffix; + var firstch; + var origword = w; + + if (w.length < 3) + return w; + + var re; + var re2; + var re3; + var re4; + + firstch = w.substr(0,1); + if (firstch == "y") + w = firstch.toUpperCase() + w.substr(1); + + // Step 1a + re = /^(.+?)(ss|i)es$/; + re2 = /^(.+?)([^s])s$/; + + if (re.test(w)) + w = w.replace(re,"$1$2"); + else if (re2.test(w)) + w = w.replace(re2,"$1$2"); + + // Step 1b + re = /^(.+?)eed$/; + re2 = /^(.+?)(ed|ing)$/; + if (re.test(w)) { + var fp = re.exec(w); + re = new RegExp(mgr0); + if (re.test(fp[1])) { + re = /.$/; + w = w.replace(re,""); + } + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1]; + re2 = new RegExp(s_v); + if (re2.test(stem)) { + w = stem; + re2 = /(at|bl|iz)$/; + re3 = new RegExp("([^aeiouylsz])\\1$"); + re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re2.test(w)) + w = w + "e"; + else if (re3.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + else if (re4.test(w)) + w = w + "e"; + } + } + + // Step 1c + re = /^(.+?)y$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(s_v); + if (re.test(stem)) + w = stem + "i"; + } + + // Step 2 + re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step2list[suffix]; + } + + // Step 3 + re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + suffix = fp[2]; + re = new RegExp(mgr0); + if (re.test(stem)) + w = stem + step3list[suffix]; + } + + // Step 4 + re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/; + re2 = /^(.+?)(s|t)(ion)$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + if (re.test(stem)) + w = stem; + } + else if (re2.test(w)) { + var fp = re2.exec(w); + stem = fp[1] + fp[2]; + re2 = new RegExp(mgr1); + if (re2.test(stem)) + w = stem; + } + + // Step 5 + re = /^(.+?)e$/; + if (re.test(w)) { + var fp = re.exec(w); + stem = fp[1]; + re = new RegExp(mgr1); + re2 = new RegExp(meq1); + re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); + if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) + w = stem; + } + re = /ll$/; + re2 = new RegExp(mgr1); + if (re.test(w) && re2.test(w)) { + re = /.$/; + w = w.replace(re,""); + } + + // and turn initial Y back to y + if (firstch == "y") + w = firstch.toLowerCase() + w.substr(1); + return w; + } +} + + +/** + * Search Module + */ +var Search = { + + _index : null, + _queued_query : null, + _pulse_status : -1, + + init : function() { + var params = $.getQueryParameters(); + if (params.q) { + var query = params.q[0]; + $('input[name="q"]')[0].value = query; + this.performSearch(query); + } + }, + + loadIndex : function(url) { + $.ajax({type: "GET", url: url, data: null, success: null, + dataType: "script", cache: true}); + }, + + setIndex : function(index) { + var q; + this._index = index; + if ((q = this._queued_query) !== null) { + this._queued_query = null; + Search.query(q); + } + }, + + hasIndex : function() { + return this._index !== null; + }, + + deferQuery : function(query) { + this._queued_query = query; + }, + + stopPulse : function() { + this._pulse_status = 0; + }, + + startPulse : function() { + if (this._pulse_status >= 0) + return; + function pulse() { + Search._pulse_status = (Search._pulse_status + 1) % 4; + var dotString = ''; + for (var i = 0; i < Search._pulse_status; i++) + dotString += '.'; + Search.dots.text(dotString); + if (Search._pulse_status > -1) + window.setTimeout(pulse, 500); + }; + pulse(); + }, + + /** + * perform a search for something + */ + performSearch : function(query) { + // create the required interface elements + this.out = $('#search-results'); + this.title = $('<h2>' + _('Searching') + '</h2>').appendTo(this.out); + this.dots = $('<span></span>').appendTo(this.title); + this.status = $('<p style="display: none"></p>').appendTo(this.out); + this.output = $('<ul class="search"/>').appendTo(this.out); + + $('#search-progress').text(_('Preparing search...')); + this.startPulse(); + + // index already loaded, the browser was quick! + if (this.hasIndex()) + this.query(query); + else + this.deferQuery(query); + }, + + query : function(query) { + var stopwords = ["and","then","into","it","as","are","in","if","for","no","there","their","was","is","be","to","that","but","they","not","such","with","by","a","on","these","of","will","this","near","the","or","at"]; + + // Stem the searchterms and add them to the correct list + var stemmer = new Stemmer(); + var searchterms = []; + var excluded = []; + var hlterms = []; + var tmp = query.split(/\s+/); + var objectterms = []; + for (var i = 0; i < tmp.length; i++) { + if (tmp[i] != "") { + objectterms.push(tmp[i].toLowerCase()); + } + + if ($u.indexOf(stopwords, tmp[i]) != -1 || tmp[i].match(/^\d+$/) || + tmp[i] == "") { + // skip this "word" + continue; + } + // stem the word + var word = stemmer.stemWord(tmp[i]).toLowerCase(); + // select the correct list + if (word[0] == '-') { + var toAppend = excluded; + word = word.substr(1); + } + else { + var toAppend = searchterms; + hlterms.push(tmp[i].toLowerCase()); + } + // only add if not already in the list + if (!$.contains(toAppend, word)) + toAppend.push(word); + }; + var highlightstring = '?highlight=' + $.urlencode(hlterms.join(" ")); + + // console.debug('SEARCH: searching for:'); + // console.info('required: ', searchterms); + // console.info('excluded: ', excluded); + + // prepare search + var filenames = this._index.filenames; + var titles = this._index.titles; + var terms = this._index.terms; + var fileMap = {}; + var files = null; + // different result priorities + var importantResults = []; + var objectResults = []; + var regularResults = []; + var unimportantResults = []; + $('#search-progress').empty(); + + // lookup as object + for (var i = 0; i < objectterms.length; i++) { + var others = [].concat(objectterms.slice(0,i), + objectterms.slice(i+1, objectterms.length)) + var results = this.performObjectSearch(objectterms[i], others); + // Assume first word is most likely to be the object, + // other words more likely to be in description. + // Therefore put matches for earlier words first. + // (Results are eventually used in reverse order). + objectResults = results[0].concat(objectResults); + importantResults = results[1].concat(importantResults); + unimportantResults = results[2].concat(unimportantResults); + } + + // perform the search on the required terms + for (var i = 0; i < searchterms.length; i++) { + var word = searchterms[i]; + // no match but word was a required one + if ((files = terms[word]) == null) + break; + if (files.length == undefined) { + files = [files]; + } + // create the mapping + for (var j = 0; j < files.length; j++) { + var file = files[j]; + if (file in fileMap) + fileMap[file].push(word); + else + fileMap[file] = [word]; + } + } + + // now check if the files don't contain excluded terms + for (var file in fileMap) { + var valid = true; + + // check if all requirements are matched + if (fileMap[file].length != searchterms.length) + continue; + + // ensure that none of the excluded terms is in the + // search result. + for (var i = 0; i < excluded.length; i++) { + if (terms[excluded[i]] == file || + $.contains(terms[excluded[i]] || [], file)) { + valid = false; + break; + } + } + + // if we have still a valid result we can add it + // to the result list + if (valid) + regularResults.push([filenames[file], titles[file], '', null]); + } + + // delete unused variables in order to not waste + // memory until list is retrieved completely + delete filenames, titles, terms; + + // now sort the regular results descending by title + regularResults.sort(function(a, b) { + var left = a[1].toLowerCase(); + var right = b[1].toLowerCase(); + return (left > right) ? -1 : ((left < right) ? 1 : 0); + }); + + // combine all results + var results = unimportantResults.concat(regularResults) + .concat(objectResults).concat(importantResults); + + // print the results + var resultCount = results.length; + function displayNextItem() { + // results left, load the summary and display it + if (results.length) { + var item = results.pop(); + var listItem = $('<li style="display:none"></li>'); + if (DOCUMENTATION_OPTIONS.FILE_SUFFIX == '') { + // dirhtml builder + var dirname = item[0] + '/'; + if (dirname.match(/\/index\/$/)) { + dirname = dirname.substring(0, dirname.length-6); + } else if (dirname == 'index/') { + dirname = ''; + } + listItem.append($('<a/>').attr('href', + DOCUMENTATION_OPTIONS.URL_ROOT + dirname + + highlightstring + item[2]).html(item[1])); + } else { + // normal html builders + listItem.append($('<a/>').attr('href', + item[0] + DOCUMENTATION_OPTIONS.FILE_SUFFIX + + highlightstring + item[2]).html(item[1])); + } + if (item[3]) { + listItem.append($('<span> (' + item[3] + ')</span>')); + Search.output.append(listItem); + listItem.slideDown(5, function() { + displayNextItem(); + }); + } else if (DOCUMENTATION_OPTIONS.HAS_SOURCE) { + $.get(DOCUMENTATION_OPTIONS.URL_ROOT + '_sources/' + + item[0] + '.txt', function(data) { + if (data != '') { + listItem.append($.makeSearchSummary(data, searchterms, hlterms)); + Search.output.append(listItem); + } + listItem.slideDown(5, function() { + displayNextItem(); + }); + }, "text"); + } else { + // no source available, just display title + Search.output.append(listItem); + listItem.slideDown(5, function() { + displayNextItem(); + }); + } + } + // search finished, update title and status message + else { + Search.stopPulse(); + Search.title.text(_('Search Results')); + if (!resultCount) + Search.status.text(_('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.')); + else + Search.status.text(_('Search finished, found %s page(s) matching the search query.').replace('%s', resultCount)); + Search.status.fadeIn(500); + } + } + displayNextItem(); + }, + + performObjectSearch : function(object, otherterms) { + var filenames = this._index.filenames; + var objects = this._index.objects; + var objnames = this._index.objnames; + var titles = this._index.titles; + + var importantResults = []; + var objectResults = []; + var unimportantResults = []; + + for (var prefix in objects) { + for (var name in objects[prefix]) { + var fullname = (prefix ? prefix + '.' : '') + name; + if (fullname.toLowerCase().indexOf(object) > -1) { + var match = objects[prefix][name]; + var objname = objnames[match[1]][2]; + var title = titles[match[0]]; + // If more than one term searched for, we require other words to be + // found in the name/title/description + if (otherterms.length > 0) { + var haystack = (prefix + ' ' + name + ' ' + + objname + ' ' + title).toLowerCase(); + var allfound = true; + for (var i = 0; i < otherterms.length; i++) { + if (haystack.indexOf(otherterms[i]) == -1) { + allfound = false; + break; + } + } + if (!allfound) { + continue; + } + } + var descr = objname + _(', in ') + title; + anchor = match[3]; + if (anchor == '') + anchor = fullname; + else if (anchor == '-') + anchor = objnames[match[1]][1] + '-' + fullname; + result = [filenames[match[0]], fullname, '#'+anchor, descr]; + switch (match[2]) { + case 1: objectResults.push(result); break; + case 0: importantResults.push(result); break; + case 2: unimportantResults.push(result); break; + } + } + } + } + + // sort results descending + objectResults.sort(function(a, b) { + return (a[1] > b[1]) ? -1 : ((a[1] < b[1]) ? 1 : 0); + }); + + importantResults.sort(function(a, b) { + return (a[1] > b[1]) ? -1 : ((a[1] < b[1]) ? 1 : 0); + }); + + unimportantResults.sort(function(a, b) { + return (a[1] > b[1]) ? -1 : ((a[1] < b[1]) ? 1 : 0); + }); + + return [importantResults, objectResults, unimportantResults] + } +} + +$(document).ready(function() { + Search.init(); +}); \ No newline at end of file diff --git a/docs/_build/html/_static/sprites.svg b/docs/_build/html/_static/sprites.svg new file mode 100644 index 00000000..a8420b9b --- /dev/null +++ b/docs/_build/html/_static/sprites.svg @@ -0,0 +1,96 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> +<!-- Generator: IcoMoon.io --> + +<svg + xmlns:dc="http://purl.org/dc/elements/1.1/" + xmlns:cc="http://creativecommons.org/ns#" + xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns="http://www.w3.org/2000/svg" + xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" + xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" + width="1008" + height="48" + viewBox="0 0 1008 48" + data-tags="bookmark" + style="margin-left: -8px; margin-top: -8px;" + fill="#333333" + id="svg2" + version="1.1" + inkscape:version="0.48.2 r9819" + sodipodi:docname="sprites.svg"> + <metadata + id="metadata30"> + <rdf:RDF> + <cc:Work + rdf:about=""> + <dc:format>image/svg+xml</dc:format> + <dc:type + rdf:resource="http://purl.org/dc/dcmitype/StillImage" /> + </cc:Work> + </rdf:RDF> + </metadata> + <defs + id="defs28" /> + <sodipodi:namedview + pagecolor="#ffffff" + bordercolor="#666666" + borderopacity="1" + objecttolerance="10" + gridtolerance="10" + guidetolerance="10" + inkscape:pageopacity="0" + inkscape:pageshadow="2" + inkscape:window-width="1562" + inkscape:window-height="1153" + id="namedview26" + showgrid="true" + inkscape:zoom="2.7460317" + inkscape:cx="651.02496" + inkscape:cy="38.446605" + inkscape:window-x="0" + inkscape:window-y="0" + inkscape:window-maximized="0" + inkscape:current-layer="svg2"> + <inkscape:grid + type="xygrid" + id="grid3007" /> + </sodipodi:namedview> + <path + d="M 141.818,22.909l-15.273-6.545l 6.105-4.361C 129.469,8.651, 124.985,6.545, 120,6.545 C 111.545,6.545, 104.5,12.556, 102.892,20.535L 98.819,18.849C 101.136,9.29, 109.728,2.182, 120,2.182c 6.452,0, 12.227,2.819, 16.224,7.27L 141.818,5.455L 141.818,22.909 z M 107.35,35.998C 110.529,39.349, 115.015,41.455, 120,41.455c 8.487,0, 15.552-6.057, 17.123-14.084l 4.069,1.741C 138.888,38.69, 130.287,45.818, 120,45.818 c-6.452,0-12.229-2.819-16.224-7.27L 98.182,42.545l0-17.455 l 15.273,6.545L 107.35,35.998z" + id="path6" /> + <path + d="M 224.71875 2.09375 L 224.71875 10.8125 C 224.71875 10.8125 201.34725 10.877 200.78125 36.125 C 201.12625 32.307 203.78675 17.375 224.71875 17.375 L 224.71875 23.90625 L 240 13 L 224.71875 2.09375 z M 198 7 C 194.676 7 192 9.676 192 13 L 192 40 C 192 43.324 194.676 46 198 46 L 229 46 C 232.324 46 235 43.324 235 40 L 235 23 L 232 25 L 232 40 C 232 41.662 230.662 43 229 43 L 198 43 C 196.338 43 195 41.662 195 40 L 195 13 C 195 11.338 196.338 10 198 10 L 210 10 L 217 7 L 198 7 z " + id="path8" /> + <path + d="M 318,0.007c-9.941,0-18,8.059-18,18c0,3.039, 0.76,5.899, 2.093,8.412l-12.516,12.513l 0.011,0.009 C 288.609,39.903, 288,41.235, 288,42.715c0,2.924, 2.37,5.293, 5.293,5.293c 1.478,0, 2.811-0.609, 3.772-1.588l-0.003-0.003l 12.511-12.51 c 2.514,1.337, 5.379,2.1, 8.425,2.1c 9.941,0, 18-8.059, 18-18C 336,8.067, 327.941,0.007, 318,0.007z M 295.192,44.545 c-0.483,0.501-1.152,0.815-1.899,0.815c-1.462,0-2.647-1.183-2.647-2.646c0-0.747, 0.315-1.414, 0.815-1.899l-0.013-0.012l 12.099-12.099 c 1.057,1.426, 2.317,2.686, 3.741,3.747L 295.192,44.545z M 318,33.009c-8.283,0-15-6.719-15-15c0-8.283, 6.717-15, 15-15 c 8.281,0, 15,6.717, 15,15C 333,26.291, 326.282,33.009, 318,33.009zM 318,7.508 C 318.412,7.508 318.75,7.844 318.75,8.258 C 318.75,8.671 318.412,9.008 318,9.008 C 313.029,9.008 309,13.038 309,18.008 C 309,18.422 308.664,18.758 308.25,18.758 C 307.836,18.758 307.5,18.422 307.5,18.008 C 307.5,12.208 312.2,7.508 318,7.508 Z" + id="path10" /> + <path + d="M 421.5,19.5L 421.5,13.5 c0-7.457-6.043-13.5-13.5-13.5c-7.457,0-13.5,6.043-13.5,13.5l0,6 c-2.486,0-4.5,2.014-4.5,4.5l0,4.5 l0,1.5 l0,3 l0,1.5 c0,7.457, 6.043,13.5, 13.5,13.5l 9,0 c 7.457,0, 13.5-6.043, 13.5-13.5l0-1.5 l0-3 l0-1.5 l0-4.5 C 426,21.513, 423.984,19.5, 421.5,19.5z M 397.5,13.5c0-5.799, 4.701-10.5, 10.5-10.5c 5.799,0, 10.5,4.701, 10.5,10.5l0,6 l-3,0 L 415.5,13.503 c0-4.143-3.357-7.5-7.5-7.5c-4.143,0-7.5,3.357-7.5,7.5L 400.5,19.5 L 397.5,19.5 L 397.5,13.5 z M 414,13.5l0,0.005 L 414,19.5 l-12,0 L 402,13.503 L 402,13.5 c0-3.314, 2.686-6, 6-6C 411.313,7.5, 414,10.187, 414,13.5z M 423,28.5 l0,1.5 l0,3 l0,1.5 c0,5.788-4.712,10.5-10.5,10.5l-9,0 c-5.788,0-10.5-4.712-10.5-10.5l0-1.5 l0-3 l0-1.5 l0-4.5 c0-0.828, 0.672-1.5, 1.5-1.5c 1.001,0, 1.999,0, 3,0l 21,0 c 0.999,0, 1.998,0, 3,0 c 0.827,0, 1.5,0.672, 1.5,1.5L 423,28.5 zM 408,28.5 C 409.656,28.5 411,29.843 411,31.5 C 411,32.413 410.508,34.152 410.001,35.523 C 409.591,36.63 409.173,37.497 408,37.497 C 406.922,37.497 406.409,36.621 406,35.508 C 405.5,34.14 405,32.41 405,31.5 C 405,29.843 406.344,28.5 408,28.5 Z" + id="path12" /> + <path + d="M 524.093,3.87C 521.625,1.405, 518.376,0, 515.174,0c-2.701,0-5.189,1.002-7.005,2.816l-7.3,7.356 c-0.022,0.021-0.048,0.035-0.071,0.057c-0.012,0.012-0.019,0.028-0.032,0.039l 0.003,0.003L 485.276,25.884 c-0.714,0.71-1.232,1.593-1.519,2.558l-3.524,12.762C 480.229,41.238, 480,42.24, 480,42.75C 480,45.648, 482.353,48, 485.256,48 c 0.578,0, 1.695-0.276, 1.736-0.282l 12.717-3.344c 0.966-0.286, 1.844-0.808, 2.558-1.524l 22.895-23.075 C 529.325,15.609, 528.855,8.625, 524.093,3.87z M 504.021,35.693c-0.123-1.353-0.506-2.68-1.079-3.94l 14.183-14.181 c 0.867,2.739, 0.422,5.604-1.479,7.506c-0.012,0.012-0.027,0.019-0.038,0.032l 0.021,0.019l-11.592,11.685 C 504.037,36.439, 504.055,36.073, 504.021,35.693z M 502.189,30.384c-0.559-0.919-1.196-1.808-1.983-2.594 c-0.916-0.916-1.968-1.635-3.066-2.238l 14.298-14.298c 1.122,0.498, 2.198,1.208, 3.147,2.157c 0.812,0.808, 1.438,1.715, 1.921,2.656 L 502.189,30.384z M 495.729,24.843c-1.389-0.559-2.844-0.879-4.302-0.898l 11.555-11.643c 1.768-1.725, 4.344-2.222, 6.88-1.593 L 495.729,24.843z M 486.25,44.809C 486.087,44.847, 485.579,44.976, 485.233,45C 484,44.985, 483,43.983, 483,42.75 c 0.018-0.252, 0.118-0.685, 0.153-0.843l 1.579-5.721c 1.715-0.046, 3.56,0.621, 5.010,2.075c 1.473,1.47, 2.166,3.351, 2.091,5.087 L 486.25,44.809z M 493.311,42.956c-0.036-2.013-0.855-4.107-2.508-5.757C 489.24,35.634, 487.194,34.731, 485.154,34.65l 1.494-5.411 c 0.108-0.36, 0.323-0.716, 0.587-1.026c 3.009-2.154, 7.636-1.518, 10.851,1.7c 3.401,3.399, 3.925,8.379, 1.306,11.352 c-0.174,0.091-0.35,0.178-0.538,0.234L 493.311,42.956z M 523.036,17.658l-2.526,2.546c0-0.339, 0.041-0.664, 0.009-1.011 c-0.264-2.902-1.617-5.709-3.815-7.904c-2.444-2.445-5.684-3.848-8.892-3.857l 2.484-2.505C 511.541,3.687, 513.276,3, 515.174,3 c 2.413,0, 4.893,1.092, 6.8,2.993c 1.79,1.787, 2.856,4.006, 3.009,6.252C 525.123,14.34, 524.431,16.261, 523.036,17.658z" + id="path14" /> + <path + d="M 600,10.5 C 600.414,10.5 600.75,10.836 600.75,11.25 C 600.75,11.664 600.412,12 600,12 C 592.009,12 585,16.206 585,21 C 585,21.414 584.664,21.75 584.25,21.75 C 583.836,21.75 583.5,21.414 583.5,21 C 583.5,15.309 591.056,10.5 600,10.5 ZM 600,3C 586.745,3, 576,11.059, 576,21c0,6.191, 4.168,11.649, 10.512,14.889 C 586.512,35.929, 586.5,35.956, 586.5,36c0,2.689-2.008,5.585-2.892,7.104c 0.002,0, 0.003,0, 0.003,0C 583.54,43.269, 583.5,43.45, 583.5,43.641 C 583.5,44.391, 584.107,45, 584.859,45C 585,45, 585.248,44.963, 585.241,44.979c 4.688-0.768, 9.104-5.075, 10.13-6.322C 596.87,38.877, 598.415,39, 600,39 c 13.253,0, 24-8.059, 24-18C 624,11.059, 613.254,3, 600,3z M 600,36c-1.376,0-2.787-0.105-4.194-0.31c-0.146-0.024-0.291-0.032-0.435-0.032 c-0.891,0-1.744,0.396-2.319,1.095c-0.642,0.782-2.469,2.526-4.627,3.809c 0.585-1.343, 1.042-2.847, 1.074-4.398 c 0.009-0.096, 0.013-0.194, 0.013-0.276c0-1.128-0.631-2.159-1.635-2.671C 582.318,30.378, 579,25.811, 579,21C 579,12.729, 588.42,6, 600,6 c 11.577,0, 21,6.729, 21,15C 621,29.271, 611.579,36, 600,36z" + id="path16" /> + <path + d="M 774 0 L 771 26.84375 L 773.96875 27.15625 L 776.65625 3 L 807.34375 3 L 810.03125 27.15625 L 813 26.84375 L 810 0 L 774 0 z M 780 6 L 780 9 L 804 9 L 804 6 L 780 6 z M 780 12 L 780 15 L 804 15 L 804 12 L 780 12 z M 780 18 L 780 21 L 804 21 L 804 18 L 780 18 z M 780 24 L 780 27 L 804 27 L 804 24 L 780 24 z M 769.5 30 C 768.675 30 768.20775 30.6545 768.46875 31.4375 L 773.53125 46.5625 C 773.79225 47.3455 774.675 48 775.5 48 L 808.5 48 C 809.325 48 810.20775 47.3455 810.46875 46.5625 L 815.53125 31.4375 C 815.79325 30.6545 815.325 30 814.5 30 L 769.5 30 z M 786 33 L 798 33 L 798 36 L 786 36 L 786 33 z " + id="path20" /> + <path + d="M 888 0 C 874.745 0 864 10.745 864 24 C 864 37.255 874.745 48 888 48 C 901.255 48 912 37.255 912 24 C 912 10.745 901.255 0 888 0 z M 888 3 C 899.59798 3 909 12.402018 909 24 C 909 33.513233 902.67471 41.543499 894 44.125 L 894 43.25 L 894 41.53125 L 894 39.65625 C 894 37.76525 893.32825 36.35975 892.03125 35.46875 C 892.84425 35.39075 893.60225 35.29625 894.28125 35.15625 C 894.96025 35.01625 895.6795 34.8275 896.4375 34.5625 C 897.1955 34.2975 897.86675 33.96075 898.46875 33.59375 C 899.07075 33.22675 899.66475 32.74225 900.21875 32.15625 C 900.77275 31.57025 901.21875 30.9295 901.59375 30.1875 C 901.96875 29.4455 902.281 28.539 902.5 27.5 C 902.719 26.461 902.8125 25.3125 902.8125 24.0625 C 902.8125 21.6405 902.04675 19.579 900.46875 17.875 C 901.18775 16 901.09375 13.953 900.21875 11.75 L 899.625 11.6875 C 899.219 11.6405 898.4915 11.82775 897.4375 12.21875 C 896.3835 12.60975 895.21925 13.234 893.90625 14.125 C 892.04725 13.609 890.09375 13.375 888.09375 13.375 C 886.07775 13.375 884.17175 13.61 882.34375 14.125 C 881.51575 13.562 880.742 13.118 880 12.75 C 879.258 12.383 878.66375 12.133 878.21875 12 C 877.77375 11.867 877.35175 11.781 876.96875 11.75 C 876.58575 11.719 876.32775 11.70275 876.21875 11.71875 C 876.10975 11.73475 876.046 11.76525 876 11.78125 C 875.125 14.00025 875.031 16.016 875.75 17.875 C 874.172 19.578 873.375 21.6405 873.375 24.0625 C 873.375 25.3125 873.49975 26.461 873.71875 27.5 C 873.93775 28.539 874.21875 29.4455 874.59375 30.1875 C 874.96875 30.9295 875.445 31.57025 876 32.15625 C 876.555 32.74225 877.149 33.22575 877.75 33.59375 C 878.351 33.96175 879.02325 34.2975 879.78125 34.5625 C 880.53925 34.8275 881.0085 35.01625 881.6875 35.15625 C 882.3665 35.29625 883.1255 35.422 883.9375 35.5 C 882.6565 36.375 882 37.75025 882 39.65625 L 882 41.34375 L 882 43.3125 L 882 44.125 C 873.3253 41.543499 867 33.513233 867 24 C 867 12.402018 876.40203 3 888 3 z " + id="path22" /> + <path + d="M 978.072,25.441c-0.267,0.386-0.593,1.352-0.978,1.588c-0.386,0.235-0.821,0.401-1.304,0.492 c-0.485,0.093-0.986,0.134-1.503,0.118l0,2.29 l 3.7,0 L 977.988,39 l 2.987,0 l0-14.994 l-2.376,0 C 978.514,24.578, 978.339,25.056, 978.072,25.441z M 994.5,12l 3,0 c 0.83,0, 1.5-0.672, 1.5-1.5L 999,1.5 c0-0.828-0.67-1.5-1.5-1.5l-3,0 c-0.83,0-1.5,0.672-1.5,1.5l0,9 C 993,11.328, 993.67,12, 994.5,12z M 970.5,12l 3,0 c 0.828,0, 1.5-0.672, 1.5-1.5L 975,1.5 c0-0.828-0.672-1.5-1.5-1.5L 970.5,0 C 969.672,0, 969,0.672, 969,1.5l0,9 C 969,11.328, 969.672,12, 970.5,12z M 1005,6l-3,0 l0,7.5 c0,0.828-0.67,1.5-1.5,1.5l-9,0 c-0.83,0-1.5-0.672-1.5-1.5L 990,6 l-12,0 l0,7.5 c0,0.828-0.672,1.5-1.5,1.5L 967.5,15 c-0.828,0-1.5-0.672-1.5-1.5L 966,6 L 963,6 C 961.344,6, 960,7.344, 960,9l0,36 c0,1.656, 1.344,3, 3,3l 42,0 c 1.656,0, 3-1.344, 3-3L 1008,9 C 1008,7.344, 1006.656,6, 1005,6z M 1005,43.5c0,0.83-0.67,1.5-1.5,1.5L 964.5,45 c-0.828,0-1.5-0.67-1.5-1.5L 963,19.5 c0-0.828, 0.672-1.5, 1.5-1.5l 39,0 c 0.83,0, 1.5,0.672, 1.5,1.5L 1005,43.5 z M 983.977,26.973l 7.452,0 c-1.404,1.728-2.534,3.488-3.397,5.558c-0.862,2.071-0.957,4.227-1.123,6.468l 3.196,0 c 0.013-0.999-0.292-2.078-0.076-3.234c 0.219-1.157, 0.528-2.298, 0.925-3.428c 0.401-1.128, 0.897-2.192, 1.494-3.19 c 0.594-1.001, 1.28-1.844, 2.050-2.529l0-2.613 l-10.522,0 L 983.976,26.973 z" + id="path24" /> + <path + style="fill:#333333;fill-opacity:1;stroke:none" + d="M 9.46875,0 C 6.437316,0 4,2.4373158 4,5.46875 l 0,37.0625 C 4,45.562684 6.437316,48 9.46875,48 l 29.0625,0 C 41.562684,48 44,45.562684 44,42.53125 L 44,5.46875 C 44,2.4373158 41.562684,0 38.53125,0 z M 11,3 l 2,0 0,42 -2,0 C 8.784,45 7,43.216 7,41 L 7,7 C 7,4.784 8.784,3 11,3 z m 5,0 11,0 0,13 4,-3 4,3 0,-13 2,0 c 2.216,0 4,1.784 4,4 l 0,34 c 0,2.216 -1.784,4 -4,4 l -21,0 z" + id="rect3009" + inkscape:connector-curvature="0" + sodipodi:nodetypes="ssssssssssccssssccccccsssscc" /> + <path + style="font-size:medium;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:normal;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;baseline-shift:baseline;color:#000000;fill:#333333;fill-opacity:1;stroke:none;stroke-width:3;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Sans;-inkscape-font-specification:Sans" + d="M 697 -1 C 696.25371 -1 695.55642 -0.73689699 695 -0.28125 C 694.44358 0.17439699 694 0.87583597 694 1.71875 L 694 3 L 693 3 L 693 4 L 687.5 4 C 687.448 3.99729 687.39579 3.99729 687.34375 4 C 686.61183 4.0767148 685.99606 4.7640806 686 5.5 L 686 6 L 684.5 6 C 683.71462 6.0000785 683.00008 6.7146233 683 7.5 L 683 8.09375 C 682.42224 8.2980557 682.0033 8.8871877 682 9.5 L 682 12.5 C 682.00008 13.285377 682.71462 13.999921 683.5 14 L 686 14 L 686 39 L 684.75 40.1875 C 684.29266 40.451552 683.9953 40.971929 684 41.5 L 684 44.5 C 684.00008 45.285377 684.71462 45.999921 685.5 46 L 693.40625 46 L 700.5 46 L 700.65625 46 L 708.5 46 C 709.28538 45.999921 709.99992 45.285377 710 44.5 L 710 41.5 C 710.005 40.971929 709.70734 40.451552 709.25 40.1875 L 708 39 L 708 14 L 710.5 14 C 711.28538 13.999921 711.99992 13.285377 712 12.5 L 712 9.5 C 711.997 8.8871877 711.57776 8.2980557 711 8.09375 L 711 7.5 C 710.99992 6.7146233 710.28538 6.0000785 709.5 6 L 708 6 L 708 5.5 C 707.99992 4.7146233 707.28538 4.0000785 706.5 4 L 701 4 L 701 3 L 700 3 L 700 1.71875 C 700 0.87583597 699.55642 0.17439702 699 -0.28125 C 698.44358 -0.73689702 697.74629 -1 697 -1 z M 697 1 C 697.20585 1 697.5132 1.1129297 697.71875 1.28125 C 697.9243 1.4495703 698 1.6095221 698 1.71875 L 698 3 L 696 3 L 696 1.71875 C 696 1.6095221 696.0757 1.4495702 696.28125 1.28125 C 696.4868 1.1129298 696.79415 1 697 1 z M 688 7 L 706 7 L 706 8 L 708 8 C 707.9472 8.7370898 708.11489 9.2632977 709 9.0625 L 709 12 L 705 12 L 689 12 L 685 12 L 685 9.15625 C 685.81891 9.2047089 685.94068 8.6267293 686 8 L 688 8 L 688 7 z M 689 14 L 705 14 L 705 41 L 707 42.375 L 707 43 L 687 43 L 687 42.375 L 689 41 L 689 14 z M 691 16 L 691 20 L 693 20 L 693 16 L 691 16 z M 694 16 L 694 20 L 696 20 L 696 16 L 694 16 z M 698 16 L 698 20 L 700 20 L 700 16 L 698 16 z M 701 16 L 701 20 L 703 20 L 703 16 L 701 16 z M 691 21 L 691 25 L 693 25 L 693 21 L 691 21 z M 694 21 L 694 25 L 696 25 L 696 21 L 694 21 z M 698 21 L 698 25 L 700 25 L 700 21 L 698 21 z M 701 21 L 701 25 L 703 25 L 703 21 L 701 21 z M 699.375 29.625 C 698.61451 29.625 698 30.239511 698 31 C 698 31.760489 698.61451 32.375 699.375 32.375 C 700.13549 32.375 700.75 31.760489 700.75 31 C 700.75 30.239511 700.13549 29.625 699.375 29.625 z " + id="path3858" /> +</svg> diff --git a/docs/_build/html/_static/underscore.js b/docs/_build/html/_static/underscore.js new file mode 100644 index 00000000..5d899143 --- /dev/null +++ b/docs/_build/html/_static/underscore.js @@ -0,0 +1,23 @@ +// Underscore.js 0.5.5 +// (c) 2009 Jeremy Ashkenas, DocumentCloud Inc. +// Underscore is freely distributable under the terms of the MIT license. +// Portions of Underscore are inspired by or borrowed from Prototype.js, +// Oliver Steele's Functional, and John Resig's Micro-Templating. +// For all details and documentation: +// http://documentcloud.github.com/underscore/ +(function(){var j=this,n=j._,i=function(a){this._wrapped=a},m=typeof StopIteration!=="undefined"?StopIteration:"__break__",b=j._=function(a){return new i(a)};if(typeof exports!=="undefined")exports._=b;var k=Array.prototype.slice,o=Array.prototype.unshift,p=Object.prototype.toString,q=Object.prototype.hasOwnProperty,r=Object.prototype.propertyIsEnumerable;b.VERSION="0.5.5";b.each=function(a,c,d){try{if(a.forEach)a.forEach(c,d);else if(b.isArray(a)||b.isArguments(a))for(var e=0,f=a.length;e<f;e++)c.call(d, +a[e],e,a);else{var g=b.keys(a);f=g.length;for(e=0;e<f;e++)c.call(d,a[g[e]],g[e],a)}}catch(h){if(h!=m)throw h;}return a};b.map=function(a,c,d){if(a&&b.isFunction(a.map))return a.map(c,d);var e=[];b.each(a,function(f,g,h){e.push(c.call(d,f,g,h))});return e};b.reduce=function(a,c,d,e){if(a&&b.isFunction(a.reduce))return a.reduce(b.bind(d,e),c);b.each(a,function(f,g,h){c=d.call(e,c,f,g,h)});return c};b.reduceRight=function(a,c,d,e){if(a&&b.isFunction(a.reduceRight))return a.reduceRight(b.bind(d,e),c); +var f=b.clone(b.toArray(a)).reverse();b.each(f,function(g,h){c=d.call(e,c,g,h,a)});return c};b.detect=function(a,c,d){var e;b.each(a,function(f,g,h){if(c.call(d,f,g,h)){e=f;b.breakLoop()}});return e};b.select=function(a,c,d){if(a&&b.isFunction(a.filter))return a.filter(c,d);var e=[];b.each(a,function(f,g,h){c.call(d,f,g,h)&&e.push(f)});return e};b.reject=function(a,c,d){var e=[];b.each(a,function(f,g,h){!c.call(d,f,g,h)&&e.push(f)});return e};b.all=function(a,c,d){c=c||b.identity;if(a&&b.isFunction(a.every))return a.every(c, +d);var e=true;b.each(a,function(f,g,h){(e=e&&c.call(d,f,g,h))||b.breakLoop()});return e};b.any=function(a,c,d){c=c||b.identity;if(a&&b.isFunction(a.some))return a.some(c,d);var e=false;b.each(a,function(f,g,h){if(e=c.call(d,f,g,h))b.breakLoop()});return e};b.include=function(a,c){if(b.isArray(a))return b.indexOf(a,c)!=-1;var d=false;b.each(a,function(e){if(d=e===c)b.breakLoop()});return d};b.invoke=function(a,c){var d=b.rest(arguments,2);return b.map(a,function(e){return(c?e[c]:e).apply(e,d)})};b.pluck= +function(a,c){return b.map(a,function(d){return d[c]})};b.max=function(a,c,d){if(!c&&b.isArray(a))return Math.max.apply(Math,a);var e={computed:-Infinity};b.each(a,function(f,g,h){g=c?c.call(d,f,g,h):f;g>=e.computed&&(e={value:f,computed:g})});return e.value};b.min=function(a,c,d){if(!c&&b.isArray(a))return Math.min.apply(Math,a);var e={computed:Infinity};b.each(a,function(f,g,h){g=c?c.call(d,f,g,h):f;g<e.computed&&(e={value:f,computed:g})});return e.value};b.sortBy=function(a,c,d){return b.pluck(b.map(a, +function(e,f,g){return{value:e,criteria:c.call(d,e,f,g)}}).sort(function(e,f){e=e.criteria;f=f.criteria;return e<f?-1:e>f?1:0}),"value")};b.sortedIndex=function(a,c,d){d=d||b.identity;for(var e=0,f=a.length;e<f;){var g=e+f>>1;d(a[g])<d(c)?(e=g+1):(f=g)}return e};b.toArray=function(a){if(!a)return[];if(a.toArray)return a.toArray();if(b.isArray(a))return a;if(b.isArguments(a))return k.call(a);return b.values(a)};b.size=function(a){return b.toArray(a).length};b.first=function(a,c,d){return c&&!d?k.call(a, +0,c):a[0]};b.rest=function(a,c,d){return k.call(a,b.isUndefined(c)||d?1:c)};b.last=function(a){return a[a.length-1]};b.compact=function(a){return b.select(a,function(c){return!!c})};b.flatten=function(a){return b.reduce(a,[],function(c,d){if(b.isArray(d))return c.concat(b.flatten(d));c.push(d);return c})};b.without=function(a){var c=b.rest(arguments);return b.select(a,function(d){return!b.include(c,d)})};b.uniq=function(a,c){return b.reduce(a,[],function(d,e,f){if(0==f||(c===true?b.last(d)!=e:!b.include(d, +e)))d.push(e);return d})};b.intersect=function(a){var c=b.rest(arguments);return b.select(b.uniq(a),function(d){return b.all(c,function(e){return b.indexOf(e,d)>=0})})};b.zip=function(){for(var a=b.toArray(arguments),c=b.max(b.pluck(a,"length")),d=new Array(c),e=0;e<c;e++)d[e]=b.pluck(a,String(e));return d};b.indexOf=function(a,c){if(a.indexOf)return a.indexOf(c);for(var d=0,e=a.length;d<e;d++)if(a[d]===c)return d;return-1};b.lastIndexOf=function(a,c){if(a.lastIndexOf)return a.lastIndexOf(c);for(var d= +a.length;d--;)if(a[d]===c)return d;return-1};b.range=function(a,c,d){var e=b.toArray(arguments),f=e.length<=1;a=f?0:e[0];c=f?e[0]:e[1];d=e[2]||1;e=Math.ceil((c-a)/d);if(e<=0)return[];e=new Array(e);f=a;for(var g=0;1;f+=d){if((d>0?f-c:c-f)>=0)return e;e[g++]=f}};b.bind=function(a,c){var d=b.rest(arguments,2);return function(){return a.apply(c||j,d.concat(b.toArray(arguments)))}};b.bindAll=function(a){var c=b.rest(arguments);if(c.length==0)c=b.functions(a);b.each(c,function(d){a[d]=b.bind(a[d],a)}); +return a};b.delay=function(a,c){var d=b.rest(arguments,2);return setTimeout(function(){return a.apply(a,d)},c)};b.defer=function(a){return b.delay.apply(b,[a,1].concat(b.rest(arguments)))};b.wrap=function(a,c){return function(){var d=[a].concat(b.toArray(arguments));return c.apply(c,d)}};b.compose=function(){var a=b.toArray(arguments);return function(){for(var c=b.toArray(arguments),d=a.length-1;d>=0;d--)c=[a[d].apply(this,c)];return c[0]}};b.keys=function(a){if(b.isArray(a))return b.range(0,a.length); +var c=[];for(var d in a)q.call(a,d)&&c.push(d);return c};b.values=function(a){return b.map(a,b.identity)};b.functions=function(a){return b.select(b.keys(a),function(c){return b.isFunction(a[c])}).sort()};b.extend=function(a,c){for(var d in c)a[d]=c[d];return a};b.clone=function(a){if(b.isArray(a))return a.slice(0);return b.extend({},a)};b.tap=function(a,c){c(a);return a};b.isEqual=function(a,c){if(a===c)return true;var d=typeof a;if(d!=typeof c)return false;if(a==c)return true;if(!a&&c||a&&!c)return false; +if(a.isEqual)return a.isEqual(c);if(b.isDate(a)&&b.isDate(c))return a.getTime()===c.getTime();if(b.isNaN(a)&&b.isNaN(c))return true;if(b.isRegExp(a)&&b.isRegExp(c))return a.source===c.source&&a.global===c.global&&a.ignoreCase===c.ignoreCase&&a.multiline===c.multiline;if(d!=="object")return false;if(a.length&&a.length!==c.length)return false;d=b.keys(a);var e=b.keys(c);if(d.length!=e.length)return false;for(var f in a)if(!b.isEqual(a[f],c[f]))return false;return true};b.isEmpty=function(a){return b.keys(a).length== +0};b.isElement=function(a){return!!(a&&a.nodeType==1)};b.isArray=function(a){return!!(a&&a.concat&&a.unshift)};b.isArguments=function(a){return a&&b.isNumber(a.length)&&!b.isArray(a)&&!r.call(a,"length")};b.isFunction=function(a){return!!(a&&a.constructor&&a.call&&a.apply)};b.isString=function(a){return!!(a===""||a&&a.charCodeAt&&a.substr)};b.isNumber=function(a){return p.call(a)==="[object Number]"};b.isDate=function(a){return!!(a&&a.getTimezoneOffset&&a.setUTCFullYear)};b.isRegExp=function(a){return!!(a&& +a.test&&a.exec&&(a.ignoreCase||a.ignoreCase===false))};b.isNaN=function(a){return b.isNumber(a)&&isNaN(a)};b.isNull=function(a){return a===null};b.isUndefined=function(a){return typeof a=="undefined"};b.noConflict=function(){j._=n;return this};b.identity=function(a){return a};b.breakLoop=function(){throw m;};var s=0;b.uniqueId=function(a){var c=s++;return a?a+c:c};b.template=function(a,c){a=new Function("obj","var p=[],print=function(){p.push.apply(p,arguments);};with(obj){p.push('"+a.replace(/[\r\t\n]/g, +" ").replace(/'(?=[^%]*%>)/g,"\t").split("'").join("\\'").split("\t").join("'").replace(/<%=(.+?)%>/g,"',$1,'").split("<%").join("');").split("%>").join("p.push('")+"');}return p.join('');");return c?a(c):a};b.forEach=b.each;b.foldl=b.inject=b.reduce;b.foldr=b.reduceRight;b.filter=b.select;b.every=b.all;b.some=b.any;b.head=b.first;b.tail=b.rest;b.methods=b.functions;var l=function(a,c){return c?b(a).chain():a};b.each(b.functions(b),function(a){var c=b[a];i.prototype[a]=function(){var d=b.toArray(arguments); +o.call(d,this._wrapped);return l(c.apply(b,d),this._chain)}});b.each(["pop","push","reverse","shift","sort","splice","unshift"],function(a){var c=Array.prototype[a];i.prototype[a]=function(){c.apply(this._wrapped,arguments);return l(this._wrapped,this._chain)}});b.each(["concat","join","slice"],function(a){var c=Array.prototype[a];i.prototype[a]=function(){return l(c.apply(this._wrapped,arguments),this._chain)}});i.prototype.chain=function(){this._chain=true;return this};i.prototype.value=function(){return this._wrapped}})(); diff --git a/docs/_build/html/_static/up-pressed.png b/docs/_build/html/_static/up-pressed.png new file mode 100644 index 0000000000000000000000000000000000000000..8bd587afee2fe38989383ff82010147ea56b93dd GIT binary patch literal 372 zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`jKx9jP7LeL$-D$|*pj^6U4S$Y z{B+)352QE?JR*yM+OLB!qm#z$3ZNi+iKnkC`z>}Z1|5lxjZvvUp)Z~;jv*GO&raT- z#pEb(tbY1#Ey4dH;Y+=<pEBRLsjGAOCY!v|CyvUA4wrPfZ{O_DPe^{q91)qJXqI&@ zO~JiL+CN7oqU^@cvS+{3Bz9yAOB-!e{LTNlK+)ab|H>wAPPMA->(Ug=YM6W%tgKtA zI`O=0Laf#Y-Y4f~`^K_)D_mvj{B=4?=t!I41ZLNlI~j_4kE*^nvF$)|>mH^X%(>6c z8XimFvvIAOoRJf!>6jzIa5w(S%7lxdZ{*qJxhxpj6S#UB!oTuMX^Z^6%)IfT_v-!3 z=PEaM_iSh6_`s$!$NaEMP6gw<x#pX-zc1lmBOrZAdYY~+^N*K~{#DY`%7Ol8@O1Ta JS?83{1OR?3hMxcc literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/up.png b/docs/_build/html/_static/up.png new file mode 100644 index 0000000000000000000000000000000000000000..b94625680b4a4b9647c3a6f3f283776930696aa9 GIT binary patch literal 363 zcmeAS@N?(olHy`uVBq!ia0vp^0wB!61|;P_|4#%`jKx9jP7LeL$-D$|*pj^6U4S$Y z{B+)352QE?JR*yM+OLB!qm#z$3ZNi+iKnkC`z>}xaYa3wv(2tRq1T=+jv*GO&raUx z$K)u`w*Tuor>1}ySNCesuPuG-8#b%jw0sn-5fpk^!623V@1GR6+<`78?&Rhov&jx6 z*R7KttIVGJ=8yH~|HhI(uB&NIpYp$LXT}M`Z<Dv|Q9O9-{p!t<9#srg4(I=_Xg%_r zaf7X90Rxxu?X9UB7>)D=?%dxpN#UiKM#HZsJK4DUm#Y3a5!dMF634rTxz_l%hvABb z(=Pc<$5*Xj@eE$@$89c0_oa>Y5;`&;INvn7C-9xQbH92`*_(~*lcvS}m5Z2pGdgKc z>;tJC%=6B^QS*>ubT+QGD)v`9z&&Y`y-xHu*7vDC$|9@xfdY)d)78&qol`;+01iQm A<^TWy literal 0 HcmV?d00001 diff --git a/docs/_build/html/_static/websupport.js b/docs/_build/html/_static/websupport.js new file mode 100644 index 00000000..e9bd1b85 --- /dev/null +++ b/docs/_build/html/_static/websupport.js @@ -0,0 +1,808 @@ +/* + * websupport.js + * ~~~~~~~~~~~~~ + * + * sphinx.websupport utilties for all documentation. + * + * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. + * :license: BSD, see LICENSE for details. + * + */ + +(function($) { + $.fn.autogrow = function() { + return this.each(function() { + var textarea = this; + + $.fn.autogrow.resize(textarea); + + $(textarea) + .focus(function() { + textarea.interval = setInterval(function() { + $.fn.autogrow.resize(textarea); + }, 500); + }) + .blur(function() { + clearInterval(textarea.interval); + }); + }); + }; + + $.fn.autogrow.resize = function(textarea) { + var lineHeight = parseInt($(textarea).css('line-height'), 10); + var lines = textarea.value.split('\n'); + var columns = textarea.cols; + var lineCount = 0; + $.each(lines, function() { + lineCount += Math.ceil(this.length / columns) || 1; + }); + var height = lineHeight * (lineCount + 1); + $(textarea).css('height', height); + }; +})(jQuery); + +(function($) { + var comp, by; + + function init() { + initEvents(); + initComparator(); + } + + function initEvents() { + $('a.comment-close').live("click", function(event) { + event.preventDefault(); + hide($(this).attr('id').substring(2)); + }); + $('a.vote').live("click", function(event) { + event.preventDefault(); + handleVote($(this)); + }); + $('a.reply').live("click", function(event) { + event.preventDefault(); + openReply($(this).attr('id').substring(2)); + }); + $('a.close-reply').live("click", function(event) { + event.preventDefault(); + closeReply($(this).attr('id').substring(2)); + }); + $('a.sort-option').live("click", function(event) { + event.preventDefault(); + handleReSort($(this)); + }); + $('a.show-proposal').live("click", function(event) { + event.preventDefault(); + showProposal($(this).attr('id').substring(2)); + }); + $('a.hide-proposal').live("click", function(event) { + event.preventDefault(); + hideProposal($(this).attr('id').substring(2)); + }); + $('a.show-propose-change').live("click", function(event) { + event.preventDefault(); + showProposeChange($(this).attr('id').substring(2)); + }); + $('a.hide-propose-change').live("click", function(event) { + event.preventDefault(); + hideProposeChange($(this).attr('id').substring(2)); + }); + $('a.accept-comment').live("click", function(event) { + event.preventDefault(); + acceptComment($(this).attr('id').substring(2)); + }); + $('a.delete-comment').live("click", function(event) { + event.preventDefault(); + deleteComment($(this).attr('id').substring(2)); + }); + $('a.comment-markup').live("click", function(event) { + event.preventDefault(); + toggleCommentMarkupBox($(this).attr('id').substring(2)); + }); + } + + /** + * Set comp, which is a comparator function used for sorting and + * inserting comments into the list. + */ + function setComparator() { + // If the first three letters are "asc", sort in ascending order + // and remove the prefix. + if (by.substring(0,3) == 'asc') { + var i = by.substring(3); + comp = function(a, b) { return a[i] - b[i]; }; + } else { + // Otherwise sort in descending order. + comp = function(a, b) { return b[by] - a[by]; }; + } + + // Reset link styles and format the selected sort option. + $('a.sel').attr('href', '#').removeClass('sel'); + $('a.by' + by).removeAttr('href').addClass('sel'); + } + + /** + * Create a comp function. If the user has preferences stored in + * the sortBy cookie, use those, otherwise use the default. + */ + function initComparator() { + by = 'rating'; // Default to sort by rating. + // If the sortBy cookie is set, use that instead. + if (document.cookie.length > 0) { + var start = document.cookie.indexOf('sortBy='); + if (start != -1) { + start = start + 7; + var end = document.cookie.indexOf(";", start); + if (end == -1) { + end = document.cookie.length; + by = unescape(document.cookie.substring(start, end)); + } + } + } + setComparator(); + } + + /** + * Show a comment div. + */ + function show(id) { + $('#ao' + id).hide(); + $('#ah' + id).show(); + var context = $.extend({id: id}, opts); + var popup = $(renderTemplate(popupTemplate, context)).hide(); + popup.find('textarea[name="proposal"]').hide(); + popup.find('a.by' + by).addClass('sel'); + var form = popup.find('#cf' + id); + form.submit(function(event) { + event.preventDefault(); + addComment(form); + }); + $('#s' + id).after(popup); + popup.slideDown('fast', function() { + getComments(id); + }); + } + + /** + * Hide a comment div. + */ + function hide(id) { + $('#ah' + id).hide(); + $('#ao' + id).show(); + var div = $('#sc' + id); + div.slideUp('fast', function() { + div.remove(); + }); + } + + /** + * Perform an ajax request to get comments for a node + * and insert the comments into the comments tree. + */ + function getComments(id) { + $.ajax({ + type: 'GET', + url: opts.getCommentsURL, + data: {node: id}, + success: function(data, textStatus, request) { + var ul = $('#cl' + id); + var speed = 100; + $('#cf' + id) + .find('textarea[name="proposal"]') + .data('source', data.source); + + if (data.comments.length === 0) { + ul.html('<li>No comments yet.</li>'); + ul.data('empty', true); + } else { + // If there are comments, sort them and put them in the list. + var comments = sortComments(data.comments); + speed = data.comments.length * 100; + appendComments(comments, ul); + ul.data('empty', false); + } + $('#cn' + id).slideUp(speed + 200); + ul.slideDown(speed); + }, + error: function(request, textStatus, error) { + showError('Oops, there was a problem retrieving the comments.'); + }, + dataType: 'json' + }); + } + + /** + * Add a comment via ajax and insert the comment into the comment tree. + */ + function addComment(form) { + var node_id = form.find('input[name="node"]').val(); + var parent_id = form.find('input[name="parent"]').val(); + var text = form.find('textarea[name="comment"]').val(); + var proposal = form.find('textarea[name="proposal"]').val(); + + if (text == '') { + showError('Please enter a comment.'); + return; + } + + // Disable the form that is being submitted. + form.find('textarea,input').attr('disabled', 'disabled'); + + // Send the comment to the server. + $.ajax({ + type: "POST", + url: opts.addCommentURL, + dataType: 'json', + data: { + node: node_id, + parent: parent_id, + text: text, + proposal: proposal + }, + success: function(data, textStatus, error) { + // Reset the form. + if (node_id) { + hideProposeChange(node_id); + } + form.find('textarea') + .val('') + .add(form.find('input')) + .removeAttr('disabled'); + var ul = $('#cl' + (node_id || parent_id)); + if (ul.data('empty')) { + $(ul).empty(); + ul.data('empty', false); + } + insertComment(data.comment); + var ao = $('#ao' + node_id); + ao.find('img').attr({'src': opts.commentBrightImage}); + if (node_id) { + // if this was a "root" comment, remove the commenting box + // (the user can get it back by reopening the comment popup) + $('#ca' + node_id).slideUp(); + } + }, + error: function(request, textStatus, error) { + form.find('textarea,input').removeAttr('disabled'); + showError('Oops, there was a problem adding the comment.'); + } + }); + } + + /** + * Recursively append comments to the main comment list and children + * lists, creating the comment tree. + */ + function appendComments(comments, ul) { + $.each(comments, function() { + var div = createCommentDiv(this); + ul.append($(document.createElement('li')).html(div)); + appendComments(this.children, div.find('ul.comment-children')); + // To avoid stagnating data, don't store the comments children in data. + this.children = null; + div.data('comment', this); + }); + } + + /** + * After adding a new comment, it must be inserted in the correct + * location in the comment tree. + */ + function insertComment(comment) { + var div = createCommentDiv(comment); + + // To avoid stagnating data, don't store the comments children in data. + comment.children = null; + div.data('comment', comment); + + var ul = $('#cl' + (comment.node || comment.parent)); + var siblings = getChildren(ul); + + var li = $(document.createElement('li')); + li.hide(); + + // Determine where in the parents children list to insert this comment. + for(i=0; i < siblings.length; i++) { + if (comp(comment, siblings[i]) <= 0) { + $('#cd' + siblings[i].id) + .parent() + .before(li.html(div)); + li.slideDown('fast'); + return; + } + } + + // If we get here, this comment rates lower than all the others, + // or it is the only comment in the list. + ul.append(li.html(div)); + li.slideDown('fast'); + } + + function acceptComment(id) { + $.ajax({ + type: 'POST', + url: opts.acceptCommentURL, + data: {id: id}, + success: function(data, textStatus, request) { + $('#cm' + id).fadeOut('fast'); + $('#cd' + id).removeClass('moderate'); + }, + error: function(request, textStatus, error) { + showError('Oops, there was a problem accepting the comment.'); + } + }); + } + + function deleteComment(id) { + $.ajax({ + type: 'POST', + url: opts.deleteCommentURL, + data: {id: id}, + success: function(data, textStatus, request) { + var div = $('#cd' + id); + if (data == 'delete') { + // Moderator mode: remove the comment and all children immediately + div.slideUp('fast', function() { + div.remove(); + }); + return; + } + // User mode: only mark the comment as deleted + div + .find('span.user-id:first') + .text('[deleted]').end() + .find('div.comment-text:first') + .text('[deleted]').end() + .find('#cm' + id + ', #dc' + id + ', #ac' + id + ', #rc' + id + + ', #sp' + id + ', #hp' + id + ', #cr' + id + ', #rl' + id) + .remove(); + var comment = div.data('comment'); + comment.username = '[deleted]'; + comment.text = '[deleted]'; + div.data('comment', comment); + }, + error: function(request, textStatus, error) { + showError('Oops, there was a problem deleting the comment.'); + } + }); + } + + function showProposal(id) { + $('#sp' + id).hide(); + $('#hp' + id).show(); + $('#pr' + id).slideDown('fast'); + } + + function hideProposal(id) { + $('#hp' + id).hide(); + $('#sp' + id).show(); + $('#pr' + id).slideUp('fast'); + } + + function showProposeChange(id) { + $('#pc' + id).hide(); + $('#hc' + id).show(); + var textarea = $('#pt' + id); + textarea.val(textarea.data('source')); + $.fn.autogrow.resize(textarea[0]); + textarea.slideDown('fast'); + } + + function hideProposeChange(id) { + $('#hc' + id).hide(); + $('#pc' + id).show(); + var textarea = $('#pt' + id); + textarea.val('').removeAttr('disabled'); + textarea.slideUp('fast'); + } + + function toggleCommentMarkupBox(id) { + $('#mb' + id).toggle(); + } + + /** Handle when the user clicks on a sort by link. */ + function handleReSort(link) { + var classes = link.attr('class').split(/\s+/); + for (var i=0; i<classes.length; i++) { + if (classes[i] != 'sort-option') { + by = classes[i].substring(2); + } + } + setComparator(); + // Save/update the sortBy cookie. + var expiration = new Date(); + expiration.setDate(expiration.getDate() + 365); + document.cookie= 'sortBy=' + escape(by) + + ';expires=' + expiration.toUTCString(); + $('ul.comment-ul').each(function(index, ul) { + var comments = getChildren($(ul), true); + comments = sortComments(comments); + appendComments(comments, $(ul).empty()); + }); + } + + /** + * Function to process a vote when a user clicks an arrow. + */ + function handleVote(link) { + if (!opts.voting) { + showError("You'll need to login to vote."); + return; + } + + var id = link.attr('id'); + if (!id) { + // Didn't click on one of the voting arrows. + return; + } + // If it is an unvote, the new vote value is 0, + // Otherwise it's 1 for an upvote, or -1 for a downvote. + var value = 0; + if (id.charAt(1) != 'u') { + value = id.charAt(0) == 'u' ? 1 : -1; + } + // The data to be sent to the server. + var d = { + comment_id: id.substring(2), + value: value + }; + + // Swap the vote and unvote links. + link.hide(); + $('#' + id.charAt(0) + (id.charAt(1) == 'u' ? 'v' : 'u') + d.comment_id) + .show(); + + // The div the comment is displayed in. + var div = $('div#cd' + d.comment_id); + var data = div.data('comment'); + + // If this is not an unvote, and the other vote arrow has + // already been pressed, unpress it. + if ((d.value !== 0) && (data.vote === d.value * -1)) { + $('#' + (d.value == 1 ? 'd' : 'u') + 'u' + d.comment_id).hide(); + $('#' + (d.value == 1 ? 'd' : 'u') + 'v' + d.comment_id).show(); + } + + // Update the comments rating in the local data. + data.rating += (data.vote === 0) ? d.value : (d.value - data.vote); + data.vote = d.value; + div.data('comment', data); + + // Change the rating text. + div.find('.rating:first') + .text(data.rating + ' point' + (data.rating == 1 ? '' : 's')); + + // Send the vote information to the server. + $.ajax({ + type: "POST", + url: opts.processVoteURL, + data: d, + error: function(request, textStatus, error) { + showError('Oops, there was a problem casting that vote.'); + } + }); + } + + /** + * Open a reply form used to reply to an existing comment. + */ + function openReply(id) { + // Swap out the reply link for the hide link + $('#rl' + id).hide(); + $('#cr' + id).show(); + + // Add the reply li to the children ul. + var div = $(renderTemplate(replyTemplate, {id: id})).hide(); + $('#cl' + id) + .prepend(div) + // Setup the submit handler for the reply form. + .find('#rf' + id) + .submit(function(event) { + event.preventDefault(); + addComment($('#rf' + id)); + closeReply(id); + }) + .find('input[type=button]') + .click(function() { + closeReply(id); + }); + div.slideDown('fast', function() { + $('#rf' + id).find('textarea').focus(); + }); + } + + /** + * Close the reply form opened with openReply. + */ + function closeReply(id) { + // Remove the reply div from the DOM. + $('#rd' + id).slideUp('fast', function() { + $(this).remove(); + }); + + // Swap out the hide link for the reply link + $('#cr' + id).hide(); + $('#rl' + id).show(); + } + + /** + * Recursively sort a tree of comments using the comp comparator. + */ + function sortComments(comments) { + comments.sort(comp); + $.each(comments, function() { + this.children = sortComments(this.children); + }); + return comments; + } + + /** + * Get the children comments from a ul. If recursive is true, + * recursively include childrens' children. + */ + function getChildren(ul, recursive) { + var children = []; + ul.children().children("[id^='cd']") + .each(function() { + var comment = $(this).data('comment'); + if (recursive) + comment.children = getChildren($(this).find('#cl' + comment.id), true); + children.push(comment); + }); + return children; + } + + /** Create a div to display a comment in. */ + function createCommentDiv(comment) { + if (!comment.displayed && !opts.moderator) { + return $('<div class="moderate">Thank you! Your comment will show up ' + + 'once it is has been approved by a moderator.</div>'); + } + // Prettify the comment rating. + comment.pretty_rating = comment.rating + ' point' + + (comment.rating == 1 ? '' : 's'); + // Make a class (for displaying not yet moderated comments differently) + comment.css_class = comment.displayed ? '' : ' moderate'; + // Create a div for this comment. + var context = $.extend({}, opts, comment); + var div = $(renderTemplate(commentTemplate, context)); + + // If the user has voted on this comment, highlight the correct arrow. + if (comment.vote) { + var direction = (comment.vote == 1) ? 'u' : 'd'; + div.find('#' + direction + 'v' + comment.id).hide(); + div.find('#' + direction + 'u' + comment.id).show(); + } + + if (opts.moderator || comment.text != '[deleted]') { + div.find('a.reply').show(); + if (comment.proposal_diff) + div.find('#sp' + comment.id).show(); + if (opts.moderator && !comment.displayed) + div.find('#cm' + comment.id).show(); + if (opts.moderator || (opts.username == comment.username)) + div.find('#dc' + comment.id).show(); + } + return div; + } + + /** + * A simple template renderer. Placeholders such as <%id%> are replaced + * by context['id'] with items being escaped. Placeholders such as <#id#> + * are not escaped. + */ + function renderTemplate(template, context) { + var esc = $(document.createElement('div')); + + function handle(ph, escape) { + var cur = context; + $.each(ph.split('.'), function() { + cur = cur[this]; + }); + return escape ? esc.text(cur || "").html() : cur; + } + + return template.replace(/<([%#])([\w\.]*)\1>/g, function() { + return handle(arguments[2], arguments[1] == '%' ? true : false); + }); + } + + /** Flash an error message briefly. */ + function showError(message) { + $(document.createElement('div')).attr({'class': 'popup-error'}) + .append($(document.createElement('div')) + .attr({'class': 'error-message'}).text(message)) + .appendTo('body') + .fadeIn("slow") + .delay(2000) + .fadeOut("slow"); + } + + /** Add a link the user uses to open the comments popup. */ + $.fn.comment = function() { + return this.each(function() { + var id = $(this).attr('id').substring(1); + var count = COMMENT_METADATA[id]; + var title = count + ' comment' + (count == 1 ? '' : 's'); + var image = count > 0 ? opts.commentBrightImage : opts.commentImage; + var addcls = count == 0 ? ' nocomment' : ''; + $(this) + .append( + $(document.createElement('a')).attr({ + href: '#', + 'class': 'sphinx-comment-open' + addcls, + id: 'ao' + id + }) + .append($(document.createElement('img')).attr({ + src: image, + alt: 'comment', + title: title + })) + .click(function(event) { + event.preventDefault(); + show($(this).attr('id').substring(2)); + }) + ) + .append( + $(document.createElement('a')).attr({ + href: '#', + 'class': 'sphinx-comment-close hidden', + id: 'ah' + id + }) + .append($(document.createElement('img')).attr({ + src: opts.closeCommentImage, + alt: 'close', + title: 'close' + })) + .click(function(event) { + event.preventDefault(); + hide($(this).attr('id').substring(2)); + }) + ); + }); + }; + + var opts = { + processVoteURL: '/_process_vote', + addCommentURL: '/_add_comment', + getCommentsURL: '/_get_comments', + acceptCommentURL: '/_accept_comment', + deleteCommentURL: '/_delete_comment', + commentImage: '/static/_static/comment.png', + closeCommentImage: '/static/_static/comment-close.png', + loadingImage: '/static/_static/ajax-loader.gif', + commentBrightImage: '/static/_static/comment-bright.png', + upArrow: '/static/_static/up.png', + downArrow: '/static/_static/down.png', + upArrowPressed: '/static/_static/up-pressed.png', + downArrowPressed: '/static/_static/down-pressed.png', + voting: false, + moderator: false + }; + + if (typeof COMMENT_OPTIONS != "undefined") { + opts = jQuery.extend(opts, COMMENT_OPTIONS); + } + + var popupTemplate = '\ + <div class="sphinx-comments" id="sc<%id%>">\ + <p class="sort-options">\ + Sort by:\ + <a href="#" class="sort-option byrating">best rated</a>\ + <a href="#" class="sort-option byascage">newest</a>\ + <a href="#" class="sort-option byage">oldest</a>\ + </p>\ + <div class="comment-header">Comments</div>\ + <div class="comment-loading" id="cn<%id%>">\ + loading comments... <img src="<%loadingImage%>" alt="" /></div>\ + <ul id="cl<%id%>" class="comment-ul"></ul>\ + <div id="ca<%id%>">\ + <p class="add-a-comment">Add a comment\ + (<a href="#" class="comment-markup" id="ab<%id%>">markup</a>):</p>\ + <div class="comment-markup-box" id="mb<%id%>">\ + reStructured text markup: <i>*emph*</i>, <b>**strong**</b>, \ + <tt>``code``</tt>, \ + code blocks: <tt>::</tt> and an indented block after blank line</div>\ + <form method="post" id="cf<%id%>" class="comment-form" action="">\ + <textarea name="comment" cols="80"></textarea>\ + <p class="propose-button">\ + <a href="#" id="pc<%id%>" class="show-propose-change">\ + Propose a change ▹\ + </a>\ + <a href="#" id="hc<%id%>" class="hide-propose-change">\ + Propose a change ▿\ + </a>\ + </p>\ + <textarea name="proposal" id="pt<%id%>" cols="80"\ + spellcheck="false"></textarea>\ + <input type="submit" value="Add comment" />\ + <input type="hidden" name="node" value="<%id%>" />\ + <input type="hidden" name="parent" value="" />\ + </form>\ + </div>\ + </div>'; + + var commentTemplate = '\ + <div id="cd<%id%>" class="sphinx-comment<%css_class%>">\ + <div class="vote">\ + <div class="arrow">\ + <a href="#" id="uv<%id%>" class="vote" title="vote up">\ + <img src="<%upArrow%>" />\ + </a>\ + <a href="#" id="uu<%id%>" class="un vote" title="vote up">\ + <img src="<%upArrowPressed%>" />\ + </a>\ + </div>\ + <div class="arrow">\ + <a href="#" id="dv<%id%>" class="vote" title="vote down">\ + <img src="<%downArrow%>" id="da<%id%>" />\ + </a>\ + <a href="#" id="du<%id%>" class="un vote" title="vote down">\ + <img src="<%downArrowPressed%>" />\ + </a>\ + </div>\ + </div>\ + <div class="comment-content">\ + <p class="tagline comment">\ + <span class="user-id"><%username%></span>\ + <span class="rating"><%pretty_rating%></span>\ + <span class="delta"><%time.delta%></span>\ + </p>\ + <div class="comment-text comment"><#text#></div>\ + <p class="comment-opts comment">\ + <a href="#" class="reply hidden" id="rl<%id%>">reply ▹</a>\ + <a href="#" class="close-reply" id="cr<%id%>">reply ▿</a>\ + <a href="#" id="sp<%id%>" class="show-proposal">proposal ▹</a>\ + <a href="#" id="hp<%id%>" class="hide-proposal">proposal ▿</a>\ + <a href="#" id="dc<%id%>" class="delete-comment hidden">delete</a>\ + <span id="cm<%id%>" class="moderation hidden">\ + <a href="#" id="ac<%id%>" class="accept-comment">accept</a>\ + </span>\ + </p>\ + <pre class="proposal" id="pr<%id%>">\ +<#proposal_diff#>\ + </pre>\ + <ul class="comment-children" id="cl<%id%>"></ul>\ + </div>\ + <div class="clearleft"></div>\ + </div>\ + </div>'; + + var replyTemplate = '\ + <li>\ + <div class="reply-div" id="rd<%id%>">\ + <form id="rf<%id%>">\ + <textarea name="comment" cols="80"></textarea>\ + <input type="submit" value="Add reply" />\ + <input type="button" value="Cancel" />\ + <input type="hidden" name="parent" value="<%id%>" />\ + <input type="hidden" name="node" value="" />\ + </form>\ + </div>\ + </li>'; + + $(document).ready(function() { + init(); + }); +})(jQuery); + +$(document).ready(function() { + // add comment anchors for all paragraphs that are commentable + $('.sphinx-has-comment').comment(); + + // highlight search words in search results + $("div.context").each(function() { + var params = $.getQueryParameters(); + var terms = (params.q) ? params.q[0].split(/\s+/) : []; + var result = $(this); + $.each(terms, function() { + result.highlightText(this.toLowerCase(), 'highlighted'); + }); + }); + + // directly open comment window if requested + var anchor = document.location.hash; + if (anchor.substring(0, 9) == '#comment-') { + $('#ao' + anchor.substring(9)).click(); + document.location.hash = '#s' + anchor.substring(9); + } +}); diff --git a/docs/_build/html/advanced.html b/docs/_build/html/advanced.html new file mode 100644 index 00000000..3ef71a81 --- /dev/null +++ b/docs/_build/html/advanced.html @@ -0,0 +1,203 @@ + +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> + + +<html xmlns="http://www.w3.org/1999/xhtml"> + <head> + <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> + + <title>Advanced Usage — jrnl 1.6.3 documentation + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

Advanced Usage¶

+
+

Configuration File¶

+

The configuration file is a simple JSON file with the following options.

+
    +
  • +
    journals
    +

    paths to your journal files

    +
    +
    +
    • +
  • +
    editor
    +

    if set, executes this command to launch an external editor for writing your entries, e.g. vim or subl -w (note the -w flag to make sure _jrnl_ waits for Sublime Text to close the file before writing into the journal. If you’re using MacVim, that would be mvim -f).

    +
    +
    +
    • +
  • +
    encrypt
    +

    if true, encrypts your journal using AES.

    +
    +
    +
    • +
  • +
    tagsymbols
    +

    Symbols to be interpreted as tags. (__See note below__)

    +
    +
    +
    • +
  • +
    default_hour and default_minute
    +

    if you supply a date, such as last thursday, but no specific time, the entry will be created at this time

    +
    +
    +
    • +
  • +
    timeformat
    +

    how to format the timestamps in your journal, see the [python docs](http://docs.python.org/library/time.html#time.strftime) for reference

    +
    +
    +
    • +
  • +
    highlight
    +

    if true, tags will be highlighted in cyan.

    +
    +
    +
    • +
  • +
    linewrap
    +

    controls the width of the output. Set to false if you don’t want to wrap long lines.

    +
    +
    +
    • +
+
+

Note

+

Although it seems intuitive to use the # character for tags, there’s a drawback: on most shells, this is interpreted as a meta-character starting a comment. This means that if you type

+
jrnl Implemented endless scrolling on the #frontend of our website.
+
+

your bash will chop off everything after the # before passing it to _jrnl_). To avoid this, wrap your input into quotation marks like this:

+
jrnl "Implemented endless scrolling on the #frontend of our website."
+
+

Or use the built-in prompt or an external editor to compose your entries.

+
+
+
+

DayOne Integration¶

+

Using your DayOne journal instead of a flat text file is dead simple - instead of pointing to a text file, change your .jrnl_conf to point to your DayOne journal. This is a folder ending with .dayone, and it’s located at

+
    +
  • ~/Library/Application Support/Day One/ by default
    • +
  • ~/Dropbox/Apps/Day One/ if you’re syncing with Dropbox and
    • +
  • ~/Library/Mobile Documents/5U8NS4GX82~com~dayoneapp~dayone/Documents/ if you’re syncing with iCloud.
    • +
+

Instead of all entries being in a single file, each entry will live in a separate plist file. You can also star entries when you write them:

+
+
jrnl -star yesterday: Lunch with @Arthur
+
+
+

Multiple journal files¶

+

You can configure _jrnl_ to use with multiple journals (eg. private and work) by defining more journals in your .jrnl_config, for example:

+
{
+...
+  "journals": {
+    "default": "~/journal.txt",
+    "work":    "~/work.txt"
+  }
+}
+
+
+

The default journal gets created the first time you start _jrnl_. Now you can access the work journal by using jrnl work instead of jrnl, eg.

+
jrnl work at 10am: Meeting with @Steve
+jrnl work -n 3
+
+

will both use ~/work.txt, while jrnl -n 3 will display the last three entries from ~/journal.txt (and so does jrnl default -n 3).

+

You can also override the default options for each individual journal. If you .jrnl_conf looks like this:

+
{
+  ...
+  "encrypt": false
+  "journals": {
+    "default": "~/journal.txt",
+    "work": {
+      "journal": "~/work.txt",
+      "encrypt": true
+    },
+    "food": "~/my_recipes.txt",
+}
+
+
+

Your default and your food journals won’t be encrypted, however your work journal will! You can override all options that are present at the top level of .jrnl_conf, just make sure that at the very least you specify a "journal": ... key that points to the journal file of that journal.

+
+

Note

+

Changing encrypt to a different value will not encrypt or decrypt your journal file, it merely says whether or not your journal is encrypted. Hence manually changing this option will most likely result in your journal file being impossible to load.

+
+
+
+ + +
+
+
+ + +
+
+
+ Journal is made with love by Manuel Ebert and other fabulous people. If you need help, tweet to @maebert or submit an issue on Github. +
+ + \ No newline at end of file diff --git a/docs/_build/html/encryption.html b/docs/_build/html/encryption.html new file mode 100644 index 00000000..285a259d --- /dev/null +++ b/docs/_build/html/encryption.html @@ -0,0 +1,119 @@ + + + + + + + + + Encryption — jrnl 1.6.3 documentation + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

Encryption¶

+
+

Encrypting and decrypting¶

+

If you don’t choose to encrypt your file when you run jrnl for the first time, you can encrypt your existing journal file or change its password using

+
jrnl --encrypt
+
+
+

If it is already encrypted, you will first be asked for the current password. You can then enter a new password and your plain journal will replaced by the encrypted file. Conversely,

+
jrnl --decrypt
+
+
+

will replace your encrypted journal file by a Journal in plain text. You can also specify a filename, ie. jrnl –decrypt plain_text_copy.txt, to leave your original file untouched.

+
+
+

Storing passwords in your keychain¶

+

Whenever you encrypt your journal, you are asked whether you want to store the encryption password in your keychain. If you do this, you won’t have to enter your password every time you want to write or read your journal.

+

If you don’t initially store the password in the keychain but decide to do so at a later point – or maybe want to store it on one computer but not on another – you can simply run jrnl –encrypt on an encrypted journal and use the same password again.

+
+
+

Manual decryption¶

+

Should you ever want to decrypt your journal manually, you can do so with any program that supports the AES algorithm. The key used for encryption is the SHA-256-hash of your password, and the IV (initialisation vector) is stored in the first 16 bytes of the encrypted file. So, to decrypt a journal file in python, run:

+
import hashlib, Crypto.Cipher
+key = hashlib.sha256(my_password).digest()
+with open("my_journal.txt") as f:
+    cipher = f.read()
+    crypto = AES.new(key, AES.MODE_CBC, iv = cipher[:16])
+    plain = crypto.decrypt(cipher[16:])
+
+
+
+
+ + +
+
+
+ + +
+
+
+ Journal is made with love by Manuel Ebert and other fabulous people. If you need help, tweet to @maebert or submit an issue on Github. +
+ + \ No newline at end of file diff --git a/docs/_build/html/export.html b/docs/_build/html/export.html new file mode 100644 index 00000000..88fc3edb --- /dev/null +++ b/docs/_build/html/export.html @@ -0,0 +1,142 @@ + + + + + + + + + Import and Export — jrnl 1.6.3 documentation + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

Import and Export¶

+
+

Tag export¶

+

With:

+
jrnl --tags
+
+
+

you’ll get a list of all tags you used in your journal, sorted by most frequent. Tags occurring several times in the same entry are only counted as one.

+
+
+

List of all entries¶

+
+
jrnl –short
+

Will only display the date and title of each entry.

+
+
+

JSON export¶

+

Can do:

+
jrnl --export json
+
+

Why not create a beautiful timeline of your journal?

+
+
+

Markdown export¶

+

Use:

+
jrnl --export markdown
+
+

Markdown is a simple markup language that is human readable and can be used to be rendered to other formats (html, pdf). This README for example is formatted in markdown and github makes it look nice.

+
+
+

Text export¶

+
jrnl --export text
+
+

Pretty-prints your entire journal.

+
+
+

Export to files¶

+

You can specify the output file of your exported journal using the -o argument:

+
jrnl --export md -o journal.md
+
+

The above command will generate a file named journal.md. If the -o argument is a directory, jrnl will export each entry into an individual file:

+
jrnl --export json -o my_entries/
+
+

The contents of my_entries/ will then look like this:

+
my_entries/
+|- 2013_06_03_a-beautiful-day.json
+|- 2013_06_07_dinner-with-gabriel.json
+|- ...
+
+
+
+ + +
+
+
+ + +
+
+
+ Journal is made with love by Manuel Ebert and other fabulous people. If you need help, tweet to @maebert or submit an issue on Github. +
+ + \ No newline at end of file diff --git a/docs/_build/html/genindex.html b/docs/_build/html/genindex.html new file mode 100644 index 00000000..03259c95 --- /dev/null +++ b/docs/_build/html/genindex.html @@ -0,0 +1,88 @@ + + + + + + + + + + + Index — jrnl 1.6.3 documentation + + + + + + + + + + + + + + + + + +
+
+
+
+ + +

Index

+ +
+ +
+ + +
+
+
+ + +
+
+
+ Journal is made with love by Manuel Ebert and other fabulous people. If you need help, tweet to @maebert or submit an issue on Github. +
+ + \ No newline at end of file diff --git a/docs/_build/html/index.html b/docs/_build/html/index.html new file mode 100644 index 00000000..cedf44fb --- /dev/null +++ b/docs/_build/html/index.html @@ -0,0 +1,95 @@ + + + + + + + + + + + jrnl- The Command Line Journal + + + + + + + + + + +
+ Tell your friends +
+ +

Collect your thoughts and notes
without leaving the command line

+
+
+
+
$ jrnl today: Started writing my memoirs. On the command line. Like a boss.
+
+
+
+ +
+
+
+ +

Human friendly.

+

jrnl has a natural-language interface so you don't have to remember cryptic shortcuts when you're writing down your thoughts.

+
+
+ +

Future-proof.

+

your journals are stored in plain-text files that will still be readable in 50 years when all your fancy iPad apps will have gone the way of the Dodo.

+
+
+ +

Secure.

+

Encrypt your journals with the military-grade AES encryption. Even the NSA won't be able to read your dirty secrets.

+
+
+
+
+ +

Accessible anywhere.

+

Sync your journals with Dropbox and capture your thoughts where ever you are

+
+
+ +

DayOne compatible.

+

Read, write and search your DayOne journal from the command line.

+
+
+ +

Free & Open Source.

+

jrnl is made by by a bunch of really nice and remarkably attractive people. Maybe even you?

+
+
+ +

For work and play.

+

Effortlessly access several journals for all parts of your life.

+
+
+ +
+ Journal is made with love by Manuel Ebert and other fabulous people. If you need help, tweet to @maebert or submit an issue on Github. +
+
+ + + + + + diff --git a/docs/_build/html/installation.html b/docs/_build/html/installation.html new file mode 100644 index 00000000..d2916519 --- /dev/null +++ b/docs/_build/html/installation.html @@ -0,0 +1,115 @@ + + + + + + + + + Getting started — jrnl 1.6.3 documentation + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

Getting started¶

+
+

Installation¶

+

Install jrnl using pip

+
pip install jrnl
+
+

Or, if you want the option to encrypt your journal,

+
pip install jrnl[encrypted]
+
+

to install the dependencies for encrypting journals as well.

+
+

Note

+

Installing the encryption library, pycrypto, requires a gcc compiler. For this reason, jrnl will not install pycrypto unless explicitly told so like this. You can install PyCyrypto manually first or install it with pip install pycrypto if you have a gcc compiler.

+
+

The first time you run jrnl you will be asked where your journal file should be created and whether you wish to encrypt it.

+
+
+

Quickstart¶

+

to make a new entry, just type:

+
jrnl yesterday: Called in sick. Used the time to clean the house and spent 4h on writing my book.
+
+

and hit return. yesterday: will be interpreted as a time stamp. Everything until the first sentence mark (.?!:) will be interpreted as the title, the rest as the body. In your journal file, the result will look like this:

+
2012-03-29 09:00 Called in sick.
+Used the time to clean the house and spent 4h on writing my book.
+
+

If you just call jrnl, you will be prompted to compose your entry - but you can also configure jrnl to use your external editor.

+
+
+ + +
+
+
+ + +
+
+
+ Journal is made with love by Manuel Ebert and other fabulous people. If you need help, tweet to @maebert or submit an issue on Github. +
+ + \ No newline at end of file diff --git a/docs/_build/html/objects.inv b/docs/_build/html/objects.inv new file mode 100644 index 00000000..c0bd60f6 --- /dev/null +++ b/docs/_build/html/objects.inv @@ -0,0 +1,9 @@ +# Sphinx inventory version 2 +# Project: jrnl +# Version: 1.6.3 +# The remainder of this file is compressed using zlib. +xÚmÁ +!@ï~…Pׂ®Ý +*:DEô“3l‚;.j[ý}µëTFÑç{¢VÄ–‘n:&œ:8‘Ó£‰®2ŸSízýš«Úãµ¹d#ÛG9"6áÞ$ë¹Ì>¼¯†zñ&*± ŲÈPôål¯"A0çRëY¾Ê¡vP‘ºÄçXº’ç­ÑÇRtk|H?7î˜Øëº3€Q/º å[ +­¥kY •n›× +ý•,uË1sðý1+JÉrõ!$BØú)…J5«Ñ‹çª­ \ No newline at end of file diff --git a/docs/_build/html/overview.html b/docs/_build/html/overview.html new file mode 100644 index 00000000..59e79ecb --- /dev/null +++ b/docs/_build/html/overview.html @@ -0,0 +1,99 @@ + + + + + + + + + Overview — jrnl 1.6.3 documentation + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

Overview¶

+
+

What is jrnl?¶

+

jrnl is a simple journal application for your command line. Journals are stored as human readable plain text files - you can put them into a Dropbox folder for instant syncing and you can be assured that your journal will still be readable in 2050, when all your fancy iPad journal applications will long be forgotten.

+

jrnl also plays nice with the fabulous DayOne and can read and write directly from and to DayOne Journals.

+

Optionally, your journal can be encrypted using the 256-bit AES.

+
+
+

Why keep a journal?¶

+

Journals aren’t only for 13-year old girls and people who have too much time on their summer vacation. A journal helps you to keep track of the things you get done and how you did them. Your imagination may be limitless, but your memory isn’t. For personal use, make it a good habit to write at least 20 words a day. Just to reflect what made this day special, why you haven’t wasted it. For professional use, consider a text-based journal to be the perfect complement to your GTD todo list - a documentation of what and how you’ve done it.

+
+
+ + +
+
+
+ + +
+
+
+ Journal is made with love by Manuel Ebert and other fabulous people. If you need help, tweet to @maebert or submit an issue on Github. +
+ + \ No newline at end of file diff --git a/docs/_build/html/recipes.html b/docs/_build/html/recipes.html new file mode 100644 index 00000000..b50671e3 --- /dev/null +++ b/docs/_build/html/recipes.html @@ -0,0 +1,116 @@ + + + + + + + + + FAQ — jrnl 1.6.3 documentation + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

FAQ¶

+
+

Recipes¶

+
+

Co-occurrence of tags¶

+

If I want to find out how often I mentioned my flatmates Alberto and Melo in the same entry, I run

+
jrnl @alberto --tags | grep @melo
+
+

And will get something like @melo: 9, meaning there are 9 entries where both @alberto and @melo are tagged. How does this work? First, jrnl @alberto will filter the journal to only entries containing the tag @alberto, and then the --tags option will print out how often each tag occurred in this filtered journal. Finally, we pipe this to grep which will only display the line containing @melo.

+
+
+

Combining filters¶

+

You can do things like

+
jrnl @fixed -starred -n 10 -until "jan 2013" --short
+
+

To get a short summary of the 10 most recent, favourited entries before January 1, 2013 that are tagged with @fixed.

+
+
+
+

Known Issues¶

+
    +
  • The Windows shell prior to Windows 7 has issues with unicode encoding. If you want to use non-ascii characters, change the codepage with chcp 1252 before using jrnl (Thanks to Yves Pouplard for solving this!)
    • +
  • _jrnl_ relies on the PyCrypto package to encrypt journals, which has some known problems with installing on Windows and within virtual environments.
    • +
+
+
+ + +
+
+
+ + +
+
+
+ Journal is made with love by Manuel Ebert and other fabulous people. If you need help, tweet to @maebert or submit an issue on Github. +
+ + \ No newline at end of file diff --git a/docs/_build/html/search.html b/docs/_build/html/search.html new file mode 100644 index 00000000..226786ff --- /dev/null +++ b/docs/_build/html/search.html @@ -0,0 +1,95 @@ + + + + + + + + + Search — jrnl 1.6.3 documentation + + + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +

Search

+
+ +

+ Please activate JavaScript to enable the search + functionality. +

+
+

+ From here you can search these documents. Enter your search + words into the box below and click "search". Note that the search + function will automatically search for all of the words. Pages + containing fewer words won't appear in the result list. +

+
+ + + +
+ +
+ +
+ +
+
+
+ + +
+
+
+ Journal is made with love by Manuel Ebert and other fabulous people. If you need help, tweet to @maebert or submit an issue on Github. +
+ + \ No newline at end of file diff --git a/docs/_build/html/searchindex.js b/docs/_build/html/searchindex.js new file mode 100644 index 00000000..29b3459b --- /dev/null +++ b/docs/_build/html/searchindex.js @@ -0,0 +1 @@ +Search.setIndex({objects:{},terms:{all:[6,0,4,7,5],default_minut:7,steve:[6,7],follow:[6,7],privat:7,depend:1,"2013_06_03_a":4,readabl:[5,4],yve:3,program:2,alberto:3,sha256:2,thursdai:7,everi:2,string:6,"3am":6,fals:7,faq:[0,3],veri:7,untouch:2,recip:[0,3],flatmat:3,level:7,did:5,list:[6,0,4,5],vector:2,dayon:[0,7,5],timeformat:7,initialis:2,ten:6,sync:[5,7],sign:6,pass:7,what:[0,5],access:7,melo:3,"new":[2,1],ever:2,told:1,hash:2,gener:4,decid:2,bodi:1,met:6,path:7,valu:7,wait:7,convers:2,vacat:5,prior:3,chcp:3,implement:7,control:[6,7],linewrap:7,apr:6,app:7,vim:7,releas:0,instal:[0,3,1],txt:[2,7],mobil:7,quickstart:[0,1],from:[6,5,7],would:7,memori:5,doubl:6,two:6,todai:6,websit:7,live:7,call:1,type:[1,7],until:[6,3,1],more:7,sort:4,flat:7,python:[2,7],henc:7,flag:7,known:[0,3],word:5,hous:1,gabriel:4,work:[6,3,7],can:[1,5,3,4,2,6,7],meet:7,overrid:7,prompt:[6,1,7],fabul:5,tag:[6,0,3,4,7],want:[6,2,3,1,7],plist:7,gcc:1,multipl:[0,7],anoth:2,occur:[6,3,4],write:[6,5,1,7,2],how:[6,5,3,7],below__:7,instead:7,beach:6,after:7,sundai:6,reflect:5,befor:[6,3,7],beauti:4,mai:5,end:7,"short":[3,4],issu:[0,3],"switch":6,environ:3,jrnl:[0,1,2,3,4,5,6,7],enter:[6,2],exclus:6,frontend:7,help:5,becaus:6,cyan:7,still:5,digest:2,perfect:5,gtd:5,thank:3,fix:3,window:3,html:[4,7],requir:1,them:[6,5,7],good:5,"return":1,food:7,timestamp:[6,0,7],dai:[6,5,4,7],initi:2,"break":6,lunch:7,macvim:7,now:[6,7],choic:6,name:4,simpl:[5,4,7],crypto:2,separ:7,mode:6,each:[3,4,7],januari:3,unicod:3,my_entri:4,mean:[6,3,7],compil:1,replac:2,individu:[4,7],timelin:4,meta:7,year:[6,5],our:7,girl:5,todo:5,special:[6,5],out:3,mere:7,content:[0,4],print:[6,3,4],lubric:6,occurr:[0,3],advanc:[0,7],given:6,reason:[6,1],base:5,put:5,org:7,"byte":2,bash:7,launch:[6,7],ask:[2,1],keep:[6,0,5],filter:[6,0,3],thing:[5,3],isn:5,summari:3,imposs:7,frequent:4,first:[2,3,1,7],origin:2,render:4,mvim:7,wast:5,date:[6,4,7],alreadi:2,done:5,open:2,fanci:5,differ:7,convent:6,start:[6,0,1,7],top:7,least:[5,7],yesterdai:[6,1,7],too:5,tom:6,"final":3,store:[0,2,5],shell:[6,3,7],option:[6,5,3,1,7],specifi:[6,2,4,7],github:4,haven:5,ipad:5,hashlib:2,grep:3,whenev:[6,2],charact:[3,7],project:6,sai:7,comput:2,ani:[6,2],"__see":7,dash:6,packag:3,have:[5,1,2],seem:7,imagin:5,built:7,equival:6,note:[6,1,7],also:[5,1,7,2],exampl:[4,7],which:[6,3],combin:[6,0,3],singl:[6,7],sure:[6,7],unless:1,track:[6,5],favourit:[6,3],who:5,most:[6,3,4,7],plai:5,cipher:2,icloud:7,why:[0,4,5],don:[6,2,7],doc:7,later:2,doe:[3,7],pipe:3,"10am":7,clean:1,pouplard:3,text:[0,4,2,7,5],directli:5,find:3,current:2,onli:[6,5,3,4],explicitli:1,locat:[6,7],execut:7,pretti:4,configur:[6,0,1,7],should:[2,1],jan:3,folder:[5,7],hit:1,"2013_06_07_dinner":4,get:[0,1,5,3,4,7],jrnl_conf:7,endless:7,bar:6,sha:2,integr:[0,7],contain:[6,3],buscemi:6,where:[3,1],view:[6,0],set:7,habit:5,see:[6,7],result:[1,7],close:7,best:6,wonder:6,profession:5,someth:3,sublim:7,won:[2,7],"import":[0,4,2],kei:[2,7],complement:5,entir:4,solv:3,both:[6,3,7],instant:5,howev:7,comment:7,forgotten:5,pdf:4,com:7,strftime:7,load:7,markdown:[0,4],simpli:[6,2],point:[2,7],overview:[0,5],arbitrarili:6,dayoneapp:7,suppli:[6,7],my_recip:7,assum:6,stamp:1,quotat:7,three:7,mark:[6,1,7],json:[0,4,7],much:5,interpret:[1,7],basic:[6,0],my_journ:2,life:6,wish:1,pycyrypto:1,argument:[6,4],"5u8ns4gx82":7,last:[6,7],present:7,look:[6,4,1,7],jrnl_config:7,plain:[5,2],plain_text_copi:2,defin:7,"while":7,abov:4,"_no_":6,pinki:6,readm:4,non:3,ascii:3,sever:4,make:[6,5,4,1,7],format:[4,7],same:[2,3,4],funni:6,drawback:7,sentenc:1,document:[5,7],http:7,extern:[1,7],chang:[6,2,3,7],recent:3,off:7,mention:3,entri:[0,1,3,4,6,7],markup:4,well:1,spent:1,person:5,without:6,command:[6,0,4,7,5],thi:[1,5,3,4,2,6,7],choos:2,everyth:[6,1,7],latest:6,summer:5,just:[6,5,1,7],codepag:3,rest:1,assur:5,human:[5,4],languag:4,had:6,add:6,other:4,input:[6,7],smart:[6,0],applic:[5,7],march:6,mayb:2,read:[5,2],intuit:7,five:6,bit:5,password:[0,2],like:[6,4,3,1,7],specif:7,filenam:2,whitespac:6,manual:[0,1,7,2],arthur:7,either:6,output:[4,7],old:5,often:3,some:3,dead:7,"export":[6,0,4],librari:[1,7],noon:6,leav:2,anna:6,refer:7,limitless:5,run:[2,3,1],journal:[0,1,2,3,4,5,6,7],usag:[6,0,7],tagsymbol:7,although:[6,7],"_jrnl_":[3,7],"6am":6,surround:6,chop:7,consid:5,within:3,encod:3,compos:[6,0,1,7],wrap:7,my_password:2,subl:7,your:[0,1,2,4,5,6,7],wai:6,aren:5,support:[2,7],"long":[5,7],width:7,reli:3,editor:[6,1,7],keychain:[0,2],mode_cbc:2,line:[6,0,3,7,5],"true":7,count:4,made:5,pycrypto:[3,1],whether:[2,1,7],worlddomin:6,displai:[6,3,4,7],highlight:7,problem:3,default_hour:7,creat:[4,1,7],decrypt:[0,7,2],exist:2,file:[0,1,2,4,5,7],pip:1,happen:6,again:2,mutual:6,encrypt:[0,1,2,3,5,7],titl:[4,1],when:[5,7,2],virtual:3,"default":7,book:1,sick:1,peopl:[6,5],you:[1,5,3,4,2,6,7],intention:6,nice:[5,4],pineappl:6,star:[6,0,3,7],symbol:[6,7],asterisk:6,mondai:6,dropbox:[5,7],algorithm:2,directori:4,scroll:7,time:[1,5,4,2,6,7],avoid:7},objtypes:{},titles:["jrnl: The command-line journal","Getting started","Encryption","FAQ","Import and Export","Overview","Basic Usage","Advanced Usage"],objnames:{},filenames:["index","installation","encryption","recipes","export","overview","usage","advanced"]}) \ No newline at end of file diff --git a/docs/_build/html/usage.html b/docs/_build/html/usage.html new file mode 100644 index 00000000..70b7f41b --- /dev/null +++ b/docs/_build/html/usage.html @@ -0,0 +1,160 @@ + + + + + + + + + Basic Usage — jrnl 1.6.3 documentation + + + + + + + + + + + + + + + + + + + +
+
+
+
+ +
+

Basic Usage¶

+

jrnl has two modes: composing and viewing. Basically, whenever you don’t supply any arguments that start with a dash or double-dash, you’re in composing mode, meaning you can write your entry on the command line or an editor of your choice.

+

We intentionally break a convention on command line arguments: all arguments starting with a single dash will filter your journal before viewing it, and can be combined arbitrarily. Arguments with a double dash will control how your journal is displayed or exported and are mutually exclusive (ie. you can only specify one way to display or export your journal at a time).

+
+

Composing Entries¶

+

Composing mode is entered by either starting jrnl without any arguments – which will prompt you to write an entry or launch your editor – or by just writing an entry on the prompt, such as:

+
jrnl today at 3am: I just met Steve Buscemi in a bar! He looked funny.
+
+
+

Smart timestamps¶

+

Timestamps that work:

+
    +
  • at 6am
    • +
  • yesterday
    • +
  • last monday
    • +
  • sunday at noon
    • +
  • 2 march 2012
    • +
  • 7 apr
    • +
  • 5/20/1998 at 23:42
    • +
+
+
+

Starring entries¶

+

To mark an entry as a favourite, simply “star” it:

+
jrnl last sunday *: Best day of my life.
+
+

If you don’t want to add a date (ie. your entry will be dated as now), The following options are equivalent:

+
    +
  • jrnl *: Best day of my life.
    • +
  • jrnl *Best day of my life.
    • +
  • jrnl Best day of my life.*
    • +
+
+

Note

+

Just make sure that the asterisk sign is not surrounded by whitespaces, e.g. jrnl Best day of my life! * will not work (the reason being that the * sign has a special meaning on most shells).

+
+
+
+
+

Viewing¶

+
jrnl -n 10
+
+

will list you the ten latest entries,

+
jrnl -from "last year" -until march
+
+

everything that happened from the start of last year to the start of last march. To only see your favourite entries, use

+
jrnl -starred
+
+
+
+
+

Using Tags¶

+

Keep track of people, projects or locations, by tagging them with an @ in your entries

+
jrnl Had a wonderful day on the @beach with @Tom and @Anna.
+
+

You can filter your journal entries just like this:

+
jrnl @pinkie @WorldDomination
+
+

Will print all entries in which either @pinkie or @WorldDomination occurred.

+
jrnl -n 5 -and @pineapple @lubricant
+
+

the last five entries containing both @pineapple and @lubricant. You can change which symbols you’d like to use for tagging in the configuration.

+
+

Note

+

jrnl @pinkie @WorldDomination will switch to viewing mode because although _no_ command line arguments are given, all the input strings look like tags - jrnl will assume you want to filter by tag.

+
+
+
+ + +
+
+
+ + +
+
+
+ Journal is made with love by Manuel Ebert and other fabulous people. If you need help, tweet to @maebert or submit an issue on Github. +
+ + \ No newline at end of file diff --git a/docs/_themes/jrnl/index.html b/docs/_themes/jrnl/index.html new file mode 100755 index 00000000..b475bf51 --- /dev/null +++ b/docs/_themes/jrnl/index.html @@ -0,0 +1,93 @@ + + + + + + + + + jrnl- The Command Line Journal + + + + + + + + + + +
+ Tell your friends +
+ +

Collect your thoughts and notes
without leaving the command line

+
+
+
+
$ jrnl today: Started writing my memoirs. On the command line. Like a boss.
+
+
+
+ +
+
+
+ +

Human friendly.

+

jrnl has a natural-language interface so you don't have to remember cryptic shortcuts when you're writing down your thoughts.

+
+
+ +

Future-proof.

+

your journals are stored in plain-text files that will still be readable in 50 years when all your fancy iPad apps will have gone the way of the Dodo.

+
+
+ +

Secure.

+

Encrypt your journals with the military-grade AES encryption. Even the NSA won't be able to read your dirty secrets.

+
+
+
+
+ +

Accessible anywhere.

+

Sync your journals with Dropbox and capture your thoughts where ever you are

+
+
+ +

DayOne compatible.

+

Read, write and search your DayOne journal from the command line.

+
+
+ +

Free & Open Source.

+

jrnl is made by by a bunch of really nice and remarkably attractive people. Maybe even you?

+
+
+ +

For work and play.

+

Effortlessly access several journals for all parts of your life.

+
+
+ +
+ {{ copyright }} +
+
+ + + + + + diff --git a/docs/_themes/jrnl/layout.html b/docs/_themes/jrnl/layout.html new file mode 100755 index 00000000..dbacf31a --- /dev/null +++ b/docs/_themes/jrnl/layout.html @@ -0,0 +1,29 @@ +{% if pagename == "index" %} + {% include "index.html" %} +{% else %} + {%- extends "basic/layout.html" %} + + {%- block extrahead %} + {{ super() }} + + + + {% endblock %} + {%- block relbar1 %}{% endblock %} + {%- block relbar2 %}{% endblock %} + + {%- block sidebar2 %} + + {% endblock %} + + {%- block footer %} +
+ {{ copyright }} +
+ {%- endblock %} +{% endif %} diff --git a/docs/_themes/jrnl/relations.html b/docs/_themes/jrnl/relations.html new file mode 100755 index 00000000..3bbcde85 --- /dev/null +++ b/docs/_themes/jrnl/relations.html @@ -0,0 +1,19 @@ +

Related Topics

+ diff --git a/docs/_themes/jrnl/static/css/jrnl.css b/docs/_themes/jrnl/static/css/jrnl.css new file mode 100644 index 00000000..08f5fc2f --- /dev/null +++ b/docs/_themes/jrnl/static/css/jrnl.css @@ -0,0 +1 @@ +article,aside,details,figcaption,figure,footer,header,hgroup,nav,section,summary{display:block}audio,canvas,video{display:inline-block}audio:not([controls]){display:none;height:0}[hidden]{display:none}html{font-family:sans-serif;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}body{margin:0}a:focus{outline:thin dotted}a:active,a:hover{outline:0}h1{font-size:2em}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:bold}dfn{font-style:italic}mark{background:#ff0;color:#000}code,kbd,pre,samp{font-family:monospace,serif;font-size:1em}pre{white-space:pre;white-space:pre-wrap;word-wrap:break-word}q{quotes:"\201C" "\201D" "\2018" "\2019"}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sup{top:-0.5em}sub{bottom:-0.25em}img{border:0}svg:not(:root){overflow:hidden}figure{margin:0}fieldset{border:1px solid #c0c0c0;margin:0 2px;padding:.35em .625em .75em}legend{border:0;padding:0}button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}button,input{line-height:normal}button,html input[type="button"],input[type="reset"],input[type="submit"]{-webkit-appearance:button;cursor:pointer}button[disabled],input[disabled]{cursor:default}input[type="checkbox"],input[type="radio"]{box-sizing:border-box;padding:0}input[type="search"]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}input[type="search"]::-webkit-search-cancel-button,input[type="search"]::-webkit-search-decoration{-webkit-appearance:none}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}textarea{overflow:auto;vertical-align:top}table{border-collapse:collapse;border-spacing:0}body{font-family:"Open Sans","Helvetica Neue",sans-serif;font-weight:300;color:#333;background:#f7f8f9}body:not(.landing){padding:0 20px;padding-top:40px}body:not(.landing) h2{margin-top:40px}input{background:transparent;border:1px solid #999;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px;padding:2px 5px;color:#666;font-family:"Open Sans";font-weight:300;outline:0}input:focus{background:white}div.related{background:rgba(255,200,200,0.2)}*>a.headerlink{display:none}h1,h2,h3,h4,h5,h6{font-weight:300}a:link,a:visited{color:#deaa09;text-decoration:none}a:hover,a:active{text-decoration:underline;color:#f6c324}.literal{color:#47375d;font-size:1em;background:#e8e2ee;padding:1px 2px;-webkit-border-radius:2px;-moz-border-radius:2px;border-radius:2px;-webkit-box-shadow:inset 0 0 0 1px #c0b2d2;-moz-box-shadow:inset 0 0 0 1px #c0b2d2;-o-box-shadow:inset 0 0 0 1px #c0b2d2;box-shadow:inset 0 0 0 1px #c0b2d2}.note{background:#8c72ac;background-image:-moz-linear-gradient(top,#8c72ac 0,#6e5691 100%);background-image:-webkit-linear-gradient(top,#8c72ac 0,#6e5691 100%);background-image:-o-linear-gradient(top,#8c72ac 0,#6e5691 100%);background-image:linear-gradient(to bottom,#8c72ac 0,#6e5691 100%);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#8c72ac',endColorstr='#6e5691',GradientType=0);-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px;-webkit-box-shadow:0 2px 3px #413155;-moz-box-shadow:0 2px 3px #413155;-o-box-shadow:0 2px 3px #413155;box-shadow:0 2px 3px #413155;padding:10px 20px 10px 70px;position:relative;color:white}.note .admonition-title{display:none}.note a{color:#fade86}.note:before{content:"";display:block;background-image:url("../img/icons.png");width:32px;height:32px;display:inline-block;font-size:40px;background-size:200px 120px;background-position:-2em -2em;position:absolute;margin:auto;top:0;bottom:0;left:20px}@media(-webkit-min-device-pixel-ratio:1.5),(min--moz-device-pixel-ratio:1.5),(-o-min-device-pixel-ratio:3/2),(min-resolution:1.5dppx){.note:before{background-image:url("../img/icons@2x.png")}}.note:before.secure{background-position:0 0}.note:before.future{background-position:-1em 0}.note:before.search{background-position:-2em 0}.note:before.nli{background-position:-3em 0}.note:before.share{background-position:0 -1em}.note:before.sync{background-position:0 -1em}.note:before.dayone{background-position:-1em -1em}.note:before.github{background-position:-2em -1em}.note:before.folders{background-position:-3em -1em}.note:before.cal{background-position:-4em -1em}.note:before.left{background-position:0 -2em}.note:before.right{background-position:-1em -2em}.note:before.info{background-position:-2em -2em}.note .literal,.note .highlight-note{color:white;background:#6b518a;padding:1px 3px;-webkit-border-radius:2px;-moz-border-radius:2px;border-radius:2px;-webkit-box-shadow:inset 0 0 0 1px #8c72ac;-moz-box-shadow:inset 0 0 0 1px #8c72ac;-o-box-shadow:inset 0 0 0 1px #8c72ac;box-shadow:inset 0 0 0 1px #8c72ac}.note .highlight-note{padding:1px 10px}.note .highlight-note pre:before{content:"$ ";color:#deaa09}.highlight{background:transparent!important}.highlight-output{background:#2f1e34;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;padding:1px 20px;margin:40px auto;width:500px;-webkit-box-shadow:0 1px 8px #a0acb7;-moz-box-shadow:0 1px 8px #a0acb7;-o-box-shadow:0 1px 8px #a0acb7;box-shadow:0 1px 8px #a0acb7;position:relative;color:#f7f8f9;font-family:"Monaco","Courier New";font-size:12pt;background:#49374e}.highlight-output #args{color:#f6f7b9}.highlight-output #output{color:#9278b5}.highlight-javascript{background:#2f1e34;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;padding:1px 20px;margin:40px auto;width:500px;-webkit-box-shadow:0 1px 8px #a0acb7;-moz-box-shadow:0 1px 8px #a0acb7;-o-box-shadow:0 1px 8px #a0acb7;box-shadow:0 1px 8px #a0acb7;position:relative;color:#f7f8f9;font-family:"Monaco","Courier New";font-size:12pt;background:#49374e}.highlight-javascript #args{color:#f6f7b9}.highlight-javascript #output{color:#9278b5}.highlight-python{background:#2f1e34;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;padding:1px 20px;margin:40px auto;width:500px;-webkit-box-shadow:0 1px 8px #a0acb7;-moz-box-shadow:0 1px 8px #a0acb7;-o-box-shadow:0 1px 8px #a0acb7;box-shadow:0 1px 8px #a0acb7;position:relative;color:#f7f8f9;font-family:"Monaco","Courier New";font-size:12pt;padding:50px 20px 10px 20px}.highlight-python #args{color:#f6f7b9}.highlight-python #output{color:#9278b5}.highlight-python:before{content:"Terminal";display:block;width:100%;position:absolute;left:0;-webkit-box-shadow:inset 0 1px 0 #f4f4f4,inset 0 -1px 0 #888;-moz-box-shadow:inset 0 1px 0 #f4f4f4,inset 0 -1px 0 #888;-o-box-shadow:inset 0 1px 0 #f4f4f4,inset 0 -1px 0 #888;box-shadow:inset 0 1px 0 #f4f4f4,inset 0 -1px 0 #888;margin-top:-50px;text-align:center;height:30px;line-height:30px;color:#777;text-shadow:0 1px 0 #ddd;-webkit-border-radius:5px 5px 0 0;-moz-border-radius:5px 5px 0 0;border-radius:5px 5px 0 0;background:#eaeaea;background-image:-moz-linear-gradient(top,#eaeaea 0,#bababa 100%);background-image:-webkit-linear-gradient(top,#eaeaea 0,#bababa 100%);background-image:-o-linear-gradient(top,#eaeaea 0,#bababa 100%);background-image:linear-gradient(to bottom,#eaeaea 0,#bababa 100%);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#eaeaea',endColorstr='#bababa',GradientType=0)}.highlight-python:after{content:"";width:48px;height:30px;position:absolute;top:0;left:10px;background:url(../img/terminal.png) no-repeat center center}.highlight-python pre{margin:0 0 10px 0}.highlight-python pre:before{content:"$ ";color:#deaa09}*:hover>a.headerlink{display:inline;color:#c0b2d2;margin-left:10px;text-decoration:none}*:hover>a.headerlink:hover{color:#725794}tt{color:#47375d;font-size:1.2em}ul li{margin-bottom:10px}div.document{max-width:900px;margin:20px auto;position:relative}div.documentwrapper{margin-left:240px;padding:0}aside{position:absolute;width:220px;top:0;color:#999}aside .logo{margin:0 auto 20px auto;display:block;width:90px;height:98px}aside h2,aside h3,aside h3 a:link,aside h3 a:visited{color:#777}aside a:link,aside a:visited{color:#999}aside a:hover,aside a:active{color:#deaa09}aside input[type=submit]{display:none}aside>ul{margin:0 4px;padding:0;list-style:none}aside>ul>li{margin-bottom:10px;font-size:18px;color:#777}aside>ul>li a:link,aside>ul>li a:visited{color:#777}aside>ul>li ul{margin:10px 0 0 0;padding-left:20px;font-size:16px;color:#999}aside>ul>li ul a:link,aside>ul>li ul a:visited{color:#999}div.footer{font-size:.8em;text-align:center;margin:40px 0;color:#999}div.footer a:link,div.footer a:visited{color:#555}@media screen and (max-width:820px){body:not(.landing){padding-top:130px}body:not(.landing) .highlight-output,body:not(.landing) .highlight-python,body:not(.landing) .highlight-javascript{width:auto;max-width:500px}body:not(.landing) .highlight-python pre{margin:-10px 0 10px 0}body:not(.landing) .highlight-python:before{height:24px!important;line-height:24px;font-size:.7em}body:not(.landing) .highlight-python:after{background:0}body:not(.landing) aside{position:static}body:not(.landing) div.documentwrapper{margin:0}body:not(.landing) h1,body:not(.landing) .section{margin:0!important}body:not(.landing) aside{background-color:#f0f0f0;width:100%;margin:5px -20px;padding:5px 20px 10px 20px}body:not(.landing) #logolink{position:absolute;top:-120px;left:50%;margin-left:-49px}}@media(-webkit-min-device-pixel-ratio:1.5),(min--moz-device-pixel-ratio:1.5),(-o-min-device-pixel-ratio:3/2),(min-resolution:1.5dppx){aside .logo,body#landing #upper #logo{width:90px;height:98px;content:url(../img/logo@2x.png)}}.icon{background-image:url("../img/icons.png");width:32px;height:32px;display:inline-block;font-size:40px;background-size:200px 120px}@media(-webkit-min-device-pixel-ratio:1.5),(min--moz-device-pixel-ratio:1.5),(-o-min-device-pixel-ratio:3/2),(min-resolution:1.5dppx){.icon{background-image:url("../img/icons@2x.png")}}.icon.secure{background-position:0 0}.icon.future{background-position:-1em 0}.icon.search{background-position:-2em 0}.icon.nli{background-position:-3em 0}.icon.share{background-position:0 -1em}.icon.sync{background-position:0 -1em}.icon.dayone{background-position:-1em -1em}.icon.github{background-position:-2em -1em}.icon.folders{background-position:-3em -1em}.icon.cal{background-position:-4em -1em}.icon.left{background-position:0 -2em}.icon.right{background-position:-1em -2em}.icon.info{background-position:-2em -2em}.pre-block{background:#2f1e34;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;padding:1px 20px;margin:40px auto;width:500px;-webkit-box-shadow:0 1px 8px #a0acb7;-moz-box-shadow:0 1px 8px #a0acb7;-o-box-shadow:0 1px 8px #a0acb7;box-shadow:0 1px 8px #a0acb7;position:relative;color:#f7f8f9;font-family:"Monaco","Courier New";font-size:12pt}.pre-block #args{color:#f6f7b9}.pre-block #output{color:#9278b5}.terminal{background:#2f1e34;-webkit-border-radius:6px;-moz-border-radius:6px;border-radius:6px;padding:1px 20px;margin:40px auto;width:500px;-webkit-box-shadow:0 1px 8px #a0acb7;-moz-box-shadow:0 1px 8px #a0acb7;-o-box-shadow:0 1px 8px #a0acb7;box-shadow:0 1px 8px #a0acb7;position:relative;color:#f7f8f9;font-family:"Monaco","Courier New";font-size:12pt;padding:50px 20px 10px 20px}.terminal #args{color:#f6f7b9}.terminal #output{color:#9278b5}.terminal:before{content:"Terminal";display:block;width:100%;position:absolute;left:0;-webkit-box-shadow:inset 0 1px 0 #f4f4f4,inset 0 -1px 0 #888;-moz-box-shadow:inset 0 1px 0 #f4f4f4,inset 0 -1px 0 #888;-o-box-shadow:inset 0 1px 0 #f4f4f4,inset 0 -1px 0 #888;box-shadow:inset 0 1px 0 #f4f4f4,inset 0 -1px 0 #888;margin-top:-50px;text-align:center;height:30px;line-height:30px;color:#777;text-shadow:0 1px 0 #ddd;-webkit-border-radius:5px 5px 0 0;-moz-border-radius:5px 5px 0 0;border-radius:5px 5px 0 0;background:#eaeaea;background-image:-moz-linear-gradient(top,#eaeaea 0,#bababa 100%);background-image:-webkit-linear-gradient(top,#eaeaea 0,#bababa 100%);background-image:-o-linear-gradient(top,#eaeaea 0,#bababa 100%);background-image:linear-gradient(to bottom,#eaeaea 0,#bababa 100%);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#eaeaea',endColorstr='#bababa',GradientType=0)}.terminal:after{content:"";width:48px;height:30px;position:absolute;top:0;left:10px;background:url(../img/terminal.png) no-repeat center center}body#landing{background-color:#47375d;font-family:"Open Sans","Helvetica Neue",sans-serif;font-weight:300}body#landing #twitter{display:block;position:absolute;top:20px;right:20px;border:1px solid #47375d;padding:5px 10px 5px 30px;color:#47375d;-webkit-border-radius:3px;-moz-border-radius:3px;border-radius:3px;opacity:.7;filter:alpha(opacity= 70);background:url(../img/twitter.png) 8px center no-repeat transparent}body#landing #twitter:hover,body#landing #twitter:active{opacity:1;filter:alpha(opacity= 100);text-decoration:none}body#landing #title,body#landing .row3,body#landing .row4,body#landing #prompt{width:900px;margin:0 auto}body#landing #upper{*zoom:1;background:#f7f8f9;-webkit-box-shadow:inset 0 -6px 6px -3px #dadfe3;-moz-box-shadow:inset 0 -6px 6px -3px #dadfe3;-o-box-shadow:inset 0 -6px 6px -3px #dadfe3;box-shadow:inset 0 -6px 6px -3px #dadfe3}body#landing #upper:before,body#landing #upper:after{content:" ";display:table}body#landing #upper:after{clear:both}body#landing #upper #title{width:650px;margin:150px auto 75px auto}body#landing #upper img{float:left;margin-right:30px}body#landing #upper h1{color:#564371;font-weight:300}body#landing #upper #prompt{width:640px;margin:0 auto;*zoom:1}body#landing #upper #prompt:before,body#landing #upper #prompt:after{content:" ";display:table}body#landing #upper #prompt:after{clear:both}body#landing #upper .terminal{-webkit-border-radius:6px 6px 0 0;-moz-border-radius:6px 6px 0 0;border-radius:6px 6px 0 0;float:left;margin:0;width:500px;min-height:134px;-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}body#landing #upper .pleft,body#landing #upper .pright{text-align:center;-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box;float:left;padding-top:50px;width:70px}body#landing #upper .pleft i,body#landing #upper .pright i{opacity:.6;filter:alpha(opacity= 60)}body#landing #upper .pleft i:hover,body#landing #upper .pright i:hover{opacity:10;filter:alpha(opacity= 1000);cursor:pointer}body#landing #nav{background:#7c95ca;background-image:-moz-linear-gradient(top,#7c95ca 0,#5e7dc5 100%);background-image:-webkit-linear-gradient(top,#7c95ca 0,#5e7dc5 100%);background-image:-o-linear-gradient(top,#7c95ca 0,#5e7dc5 100%);background-image:linear-gradient(to bottom,#7c95ca 0,#5e7dc5 100%);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#7c95ca',endColorstr='#5e7dc5',GradientType=0);height:60px;-webkit-box-shadow:0 6px 6px -3px #413155;-moz-box-shadow:0 6px 6px -3px #413155;-o-box-shadow:0 6px 6px -3px #413155;box-shadow:0 6px 6px -3px #413155;text-align:center}body#landing #nav a#twitter-nav{display:none}body#landing #nav a{color:#f7f8f9;text-shadow:0 -1px 0 #253865;text-decoration:none;font-size:14pt;line-height:60px;margin:0 40px}body#landing #nav a:hover{color:#f8d055;text-shadow:0 -1px 0 #947206}body#landing #nav a.cta{background:#725794;background-image:-moz-linear-gradient(top,#725794 0,#564371 100%);background-image:-webkit-linear-gradient(top,#725794 0,#564371 100%);background-image:-o-linear-gradient(top,#725794 0,#564371 100%);background-image:linear-gradient(to bottom,#725794 0,#564371 100%);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#725794',endColorstr='#564371',GradientType=0);-webkit-box-shadow:0 1px 0 #413155;-moz-box-shadow:0 1px 0 #413155;-o-box-shadow:0 1px 0 #413155;box-shadow:0 1px 0 #413155;-webkit-border-radius:5px;-moz-border-radius:5px;border-radius:5px;padding:6px 10px 5px 10px;white-space:nowrap}body#landing #nav a.cta:hover{background:#f6c324;background-image:-moz-linear-gradient(top,#f6c324 0,#c59708 100%);background-image:-webkit-linear-gradient(top,#f6c324 0,#c59708 100%);background-image:-o-linear-gradient(top,#f6c324 0,#c59708 100%);background-image:linear-gradient(to bottom,#f6c324 0,#c59708 100%);filter:progid:DXImageTransform.Microsoft.gradient(startColorstr='#f6c324',endColorstr='#c59708',GradientType=0);-webkit-box-shadow:0 1px 0 #947206;-moz-box-shadow:0 1px 0 #947206;-o-box-shadow:0 1px 0 #947206;box-shadow:0 1px 0 #947206;text-shadow:0 -1px 0 #947206;color:#f7f8f9}body#landing #lower{color:#f7f8f9;padding-top:40px}body#landing #lower a{color:#deaa09;text-decoration:none}body#landing #lower a:hover{color:#f8d055;text-decoration:underline}body#landing #lower .row3,body#landing #lower .row4{*zoom:1;margin-bottom:20px}body#landing #lower .row3:before,body#landing #lower .row4:before,body#landing #lower .row3:after,body#landing #lower .row4:after{content:" ";display:table}body#landing #lower .row3:after,body#landing #lower .row4:after{clear:both}body#landing #lower .row3 .col,body#landing #lower .row4 .col{position:relative;padding-left:40px;float:left;width:25%;padding-right:2%;-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box}body#landing #lower .row3 .col i,body#landing #lower .row4 .col i{position:absolute;left:0;top:16px}body#landing #lower .row3 .col h3,body#landing #lower .row4 .col h3{font-size:12pt;margin-bottom:.5em}body#landing #lower .row3 .col p,body#landing #lower .row4 .col p{font-size:10pt;margin:0}body#landing #lower .row3 .col:last-child,body#landing #lower .row4 .col:last-child{padding-right:0}body#landing #lower .row3 .col{width:33.3333%}body#landing #lower .row4 .col{color:#d4d1da}body#landing #lower .row4 .col i{opacity:.8;filter:alpha(opacity= 80)}@media screen and (max-width:680px){body#landing #nav{height:auto;padding-bottom:10px}body#landing #nav a,body#landing #nav a#twitter-nav{display:block}body#landing #nav a.cta{margin:10px;padding:1px}body#landing #upper #twitter{display:none}body#landing #upper #title{margin:30px 0 10px 0}body#landing #upper #logo{backgound:red;display:block;float:none;margin:0 auto}body#landing #upper #title br{display:none}body#landing #upper .pleft,body#landing #upper .pright{display:none}body#landing #upper #prompt,body#landing #upper #title{width:100%;-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box;padding:0 20px}body#landing #upper .terminal{width:100%}}@media screen and (max-width:900px){body#landing #lower{padding:40px 20px}body#landing #lower .row3,body#landing #lower .row4{margin:0;width:auto}body#landing #lower .row3 .col,body#landing #lower .row4 .col{float:none;width:100%;text-align:center;padding:0;margin:0 0 40px 0}body#landing #lower .row3 .col h3,body#landing #lower .row4 .col h3{font-size:1.5em}body#landing #lower .row3 .col p,body#landing #lower .row4 .col p{font-size:1em}body#landing #lower .row3 .col i,body#landing #lower .row4 .col i{position:static;margin-bottom:-20px}} \ No newline at end of file diff --git a/docs/_themes/jrnl/static/img/favicon-152.png b/docs/_themes/jrnl/static/img/favicon-152.png new file mode 100644 index 0000000000000000000000000000000000000000..ac658d9ce73f8bddb02c753987998b52bc7325a2 GIT binary patch literal 3261 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 KtqLvc$o~M=2{qmT literal 0 HcmV?d00001 diff --git a/docs/_themes/jrnl/static/img/favicon.ico b/docs/_themes/jrnl/static/img/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..7c9c2c1e2ed5cbf83ae4302ce72f729bef91ea48 GIT binary patch literal 5558 zcmeHL%`XE%6d&T|LR=ks5?2>#I3RHl!G$>XAT-41!9jc+D#{6MDv^lz2&X3eCryY5 zs)?dqG)09HP1B!!Bae-*3acb$lG(SrGw=Oo-oE#;zY!u!WDAQ$=+YvJ^Mxo9LgeK= zKDXxx(V)L8*5Bz2-^vjgLB^^Cyl zp2u|e5Y}fFkxC|!xV!&0{#`td#C-y5o&{;!>zb2Tgh_rNpC4@dL4G;X_e7G`Wi~$f z#)!d~^u4LQlxE|nlBri19BT?+`QMEATXal5<^Sr0N9I50Unb&@_OLuUC2JSmQ~k*_ zKIfFeSN>P=r}9tLpU3~NOx1r?f1mk-sy~0f{+P)>jIsan|KmOWLA=u}{`C?5d;E*I zuUY)_E&O!+^SAjop9B0?N#`W`(TO}ENq0_CS7^moI(=i-(=<);ZMx9C&*zh4B#mP{ t&U!43bIjH!3}YkvjLY&Pe4fKLl)myG#{|pYiXUSR@>)JCN%y<;@c}3gBAx&M literal 0 HcmV?d00001 diff --git a/docs/_themes/jrnl/static/img/icons.png b/docs/_themes/jrnl/static/img/icons.png new file mode 100644 index 0000000000000000000000000000000000000000..bb77ca657d55a76a15859b2db8f53a9f6f5934f2 GIT binary patch literal 10460 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 literal 0 HcmV?d00001 diff --git a/docs/_themes/jrnl/static/img/logo.png b/docs/_themes/jrnl/static/img/logo.png new file mode 100644 index 0000000000000000000000000000000000000000..1ea79cf1583927ca8bdbde9f8779fecfc567b72a GIT binary patch literal 2783 zcmc&$c{tQx7ypiZ$&w~JBZX{*kSvkNOm;#)OD3`uV;g1&W1G-e#t_n&sVpUfD3UFb z2-$ZT!p~OrefNIf|KI=L`#k5K=bn3>^PF?;IiGW%T9_GeaR_q&0KkQS8(4wd9wZkw z7I5#5YH9=-6Ivf}hYeg|Y!BkWGrJ%BA2g^x^k0JLUnB>ELZLvzyMfle?t$3*0d4>m zi@o&F#|!Ox-_PxmZ-57RSz8zYI2;iMH|_*yFHu4Qt!>03>!lwWX9m8`m%TuD$mq4o z7?re8HzY_fx(GQYw?kTjn%$Z#yZmRBIyJ~`LSo-@FTM(X;4hRQ8BO3%cgt%t6OqVA zI8fL`ksAvhZ1*YI-~0`a?9f*$!=+-IbMNZ2oLxlv6~REQb%;zU=}x zff|dqo_~1Pgoq)|Cns~S5BbVO&@(}+csz3&hl-FYsAyHeEP%E7vkKNCNv4#}KLZ^6)5IdG4n3oF(+hdas-rlq{?1IYqwA zVF_hUy4BI-)$F1jmKuOQ`3mGf!rea)+X(0?BmRR)xH|LE(QFkgGkchC7tl)IPw%s$c&TynfL%!&a)Hzj!=Z41ajHNUr%-x##+b!u7Y>Nq?UVM@Y#^(CLXq9Hz z2WEfBc{s9fB=%3kxa95ROl2jNXCnM&jIWTtb~F~vtc+x?V8Y~pm%jVlk)Zs%`u$ZY zLH85n;lHP1^Q8cbz;337XJZP1Hzmt{WkX?d5D6@fJ0^!Ups*;GF*Lz4E71)wA*Uyu z0J;DsyrN4?+m{bW+Okbv)P?AECi*wB3^=#Gc*d>waIVdy*w()zdkql1tit$eZ9qxw zDkqTE6W#Wp96-hsSsE5RbE`jaM-Dfg1Mb`{1PcWP=OtNAM#uI=ECkq$qS!^xtQ%-PtHr+D=_Qf3j4$J-}$jX$zeny2Cfcm<()vv^h8x=l#UmvNa|m|c;l zvo2SqLe{se-}3RF1Q@nzm(yTiyZ_E3ewz0>kzsB39_((iF}SUCM! z$`U57H2FxhQ)*9tx-+jmok--t;g-?ml@+0*paN>UGb{=cbzCsTM;{StH>M-rvT}1U zzACBiN%K}Jx{~XsQj!|`o$8~tfO(PPqL-dB#a|cN zf-`UUOryU`#0q@QywS4{XAxn6_?33g7au#TLtzS#dD3{5-_B`(PYZn@PiX9XAHgJX z-H<4U8nY-rcSDfp<%79x81Ou>SSx64+Z<~>7-HO-MPhHzdLM3Lym1+8OEx{bxEppE zEKimON?Wk`oPjAKi4{3#r|Tm3iC4J9t^f1u0?^bLX2KB|tgFguTepvWE2DxQzu;KH z4Zhj+PqwU88)!i)6%InBZ~cqQIQ$V{Xc_GF-6$|HkT+8mPjXEys~8Rm{cZ&OtoB#g zAHG;9_voLK*|)&hT7x!248xf2*B0|m3ADa2SCDOn&c2G#Hq4`E>Muf!lDM{tpoT1- z{qsmTc=esb)BYzP(FZ)Wn~U~Eriz(9{n2IW6{TS#j|e>JuLcXMmZ()A$gTeDJ^MV7 zAN2FXYKbF=W;0#HFaJgIku)Ra>XkJ2x; zRrZ)vT~ueC2(yGIRHS#8B7MGua)BePAcQ4Lk#>0a| zF>1z-w3FSWxgb+Fovx!bQ#pkJ(A`M`OWCJ%>a>&Gen;YRvVHhI&kH1q_e&jAbtM7r zr18<`=UVOcd)`&0+>hDUa=JWjpO{p0XfgELTn#>YJQuS&L)p>UDOmOPT7r>r`!mJU zl8#LWL!b5V@t7)2ZK<0_n(}HpGM!jqB&nSQ}G&3mCM@Ih#m%}p~ literal 0 HcmV?d00001 diff --git a/docs/_themes/jrnl/static/img/logo@2x.png b/docs/_themes/jrnl/static/img/logo@2x.png new file mode 100644 index 0000000000000000000000000000000000000000..9cc3d76b6447c42cf7c19f859d3a7ccb89c01387 GIT binary patch literal 5598 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 Og4C2W70VSYg8m0xQL!Tc literal 0 HcmV?d00001 diff --git a/docs/_themes/jrnl/static/img/terminal.png b/docs/_themes/jrnl/static/img/terminal.png new file mode 100644 index 0000000000000000000000000000000000000000..b813980e142c26710e7fc337c68da072389a7df5 GIT binary patch literal 687 zcmV;g0#N;lP)h<1H#hI(d|Ibq=okRtC$%R;pI>f0`iTFi&2vsAA zO65}#!1JTTUT}QXW-}K#67w`tbO@9*X#EM03zYA zojiMHbm4rqMntcz#puvY48RkP@$X-#({5#nDCsy(6abjHqqVL@W2apcJFJeA^9%I* V;j=^1`V0U7002ovPDHLkV1ljcEfN3# literal 0 HcmV?d00001 diff --git a/docs/_themes/jrnl/static/img/twitter.png b/docs/_themes/jrnl/static/img/twitter.png new file mode 100644 index 0000000000000000000000000000000000000000..29c5a89ecaba167b599c452ee38beaecb1268ca2 GIT binary patch literal 1550 zcmV+p2J!icP)4Tx05}naRo`#hR1`jmZ&IWdKOk5~hl<6oRa0BJ8yc;~21%2p?MfD<>DVeH z9(p*dx19w`~g7O0}n_%Aq@s%d)fBDv`JHkDym6Hd+5XuAtvnwRpGmK zVkc9?T=n|PIo~X-eVh__(Z?q}P9Z-Dj?gOW6|D%o20XmjW-qs4UjrD(li^iv8@eK9k+ZFm zVRFymFOPAzG5-%Pn|1W;U4vNroTa&AxDScmEA~{ri9gr1^c?U@uwSpaNnw8l_>cP1 zd;)kMQS_;jeRSUEM_*s96y65j1$)tOrwdK{YIQMt92l|D^(E_=$Rjw{b!QT@q!)ni zR`|5oW9X5n$Wv+HVc@|^eX5yXnsHX8PF3UX~a6)MwxDE0HaPjyrlI!;jX{6Kvuh*8ej?;85ekN$?5uuCiS zBTvvVG+XTxAO{m@bvM#Jr)z6J><&E22D|vq?Y?Vkbo_DijopiF$2PET#mZ8eu=y$(ArYkv7@Ex`GL?QCc!_*KFrd&;n1r7 zqW-CFs9&fT)ZaU5gc&=gBz-DaCw(vdOp0__x+47~U6sC(E(JNe@4cTT*n6*E zVH4eoU1-&7pEV~_PRe`a7v+@vy!^5}8?Y3)UmlaER00009a7bBm000XU000XU0RWnu7ytkPkV!;AR5%gM zl1)y+Koo%An-{ z)_Xxcy3NknissZ9LVy9g5Gh8$D{$5mwW%yqK$f#z1@x!$(KQ<^P`eg=mJ$Tawy)VT z(qz8Ofes|-7p1X7xDav=tni{F%bFgD&{rFfi6YMeWudwUdkK0%K-(&f^LcuDDuZ3+ zSa;~Mb&r~CE4_&S2PufHgdGP;XqdZ1t9~{Jk2-#CNOz)_Qm?E4?FAUWE*|f4v+Fo? zPf(G1^f4QCKm+mjJ~6~`*B3d2_q0d+b1A6|^c1?Lv#irf5cTEa>E@@;YIa(pDX5JL59{>M9-~76lWQT&k0{{R307*qoM6N<$g3eFh A-v9sr literal 0 HcmV?d00001 diff --git a/docs/_themes/jrnl/static/js/landing.js b/docs/_themes/jrnl/static/js/landing.js new file mode 100644 index 00000000..0f704aa9 --- /dev/null +++ b/docs/_themes/jrnl/static/js/landing.js @@ -0,0 +1,92 @@ +var phrases = [ + ["", "today: Started writing my memoirs. On the command line. Like a boss.", ""], + ["", "yesterday 2pm: used jrnl to keep track of accomplished tasks. The done.txt for my todo.txt", ""], + ["-from 2009 -until may", "", "(Displays all entries from January 2009 to last may)"], + ["", "A day on the beach with @beth and @frank. Taggidy-tag-tag.", ""], + ["--tags", "", "@idea 7
@beth 5"], + ["--export json", "", "(Exports your entire journal to json)"], + ["--encrypt", "", "(256 bit AES encryption. Crack this, NSA.)"] +] + +var args = document.getElementById("args"); +var input = document.getElementById("input"); +var output = document.getElementById("output"); +var right = document.getElementById("right"); +var left = document.getElementById("left"); +var current = 0 +var timer = null; + +var next = function() { + clearTimeout(timer); + reveal(++current % phrases.length); + setTimeout(next, 5000); +} +var prev = function() { + reveal(--current % phrases.length); +} + +var reveal = function(idx) { + var args_text = phrases[idx][0]; + var input_text = phrases[idx][1]; + var output_text = phrases[idx][2]; + var old_dix = idx == 0 ? phrases.length - 1 : idx - 1; + console.log(idx, old_dix, "++++++++++++") + var old_args_text = phrases[old_dix][0] + var old_input_text = phrases[old_dix][1] + var old_output_text =phrases[old_dix][2] + console.log(args_text, input_text, output_text) + console.log(old_args_text, old_input_text, old_output_text) + var s4 = function() {fadeIn(output_text, output);} + var s3 = function() {letter(input_text, input, s4);} + var s2 = function() {letter(args_text, args, s3);} + var s1 = function() {unletter(old_args_text, args, s2);} + var s0 = function() {unletter(old_input_text, input, s1);} + fadeOut(old_output_text, output, s0, 10); + // letter(input_text, input); + // output.innerHTML = output_text; +} +var fadeIn = function(text, element, next, step) { + step = step || 0 + var nx = function() { fadeIn(text, element, next, ++step); } + if (step==0) { + element.innerHTML = ""; + setTimeout(nx, 550); + return; + } + if (step==1) {element.innerHTML = text;} + if (step>10 || !text) { if (next) {next(); return;} else return;} + element.style.opacity = (step-1)/10; + element.style.filter = 'alpha(opacity=' + (step-1)*10 + ')'; + setTimeout(nx, 50); +} +var fadeOut = function(text, element, next, step) { + if (step===10) element.innerHTML = text; + if (step<0 || !text) { + element.innerHTML = ""; + if (next) {next(); return;} + else return; + } + element.style.opacity = step/10; + element.style.filter = 'alpha(opacity=' + step*10 + ')'; + var nx = function() { fadeOut(text, element, next, --step); } + setTimeout(nx, 50); +} + +var unletter = function(text, element, next, timeout, index) { + timeout = timeout||10; + if (index==null) index = text.length; + if (index==-1 || !text.length) { if (next) {next(); return;} else return;} + element.innerHTML = text.substring(0, index); + var nx = function() { unletter(text, element, next, timeout, --index); } + setTimeout(nx, timeout); +} + +var letter = function(text, element, next, timeout, index) { + timeout = timeout||35; + index = index||0; + if (index > text.length || !text.length) { if (next) {next(); return;} else return;} + element.innerHTML = text.substring(0, index); + var nx = function() { letter(text, element, next, timeout, ++index); } + setTimeout(nx, timeout); +} +setTimeout(next, 3000); diff --git a/docs/_themes/jrnl/static/landing.svg b/docs/_themes/jrnl/static/landing.svg new file mode 100644 index 00000000..cbdb9488 --- /dev/null +++ b/docs/_themes/jrnl/static/landing.svg @@ -0,0 +1,3558 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + image/svg+xml + + + + + + + + + + + + + + + Collect your thoughts and noteswithout leaving the command line. + + + + + + + + + + + + + + + + + + + + + + + + + + Terminal + Terminal + + $ jrnl today: Started writing my Memoirs. On the command line. Like a boss. + + + + + + + + + + + + Collect your thoughts and noteswithout leaving the command line. + Secure.Ecnrypt your Journal with military-grade AES encryption so not even the NSA can read your dirty secrets. Human friendly. jrnl has a natural language interface so you don't have to remember cryptic shortcuts while writing down your thoghts. Future-proof.Your journals are stored as plain-text files and you will still be able to open them in 50 years when all your fancy iPad apps have gone the way of the Dodo. Accessible Anywhere.Ecnrypt your Journal with military-grade AES encryption so not even the NSA can read your dirty secrets. DayOne compatible.Your journals are stored as plain-text files and you will still be able to open them in 50 years when all . Free & Open SourceYour journals are stored as plain-text files and you will still be able to open them in 50 years when all . DayOne compatible.Your journals are stored as plain-text files and you will still be able to open them in 50 years when all . + + + + + + Download + + + Download + Documentation + Documentation + Fork me on Github + Fork me on Github + + jrnl is lovingly crafter by Manuel Ebert and other great people. + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/docs/_themes/jrnl/static/less/3L.less b/docs/_themes/jrnl/static/less/3L.less new file mode 100644 index 00000000..583c51f7 --- /dev/null +++ b/docs/_themes/jrnl/static/less/3L.less @@ -0,0 +1,1369 @@ +///* +// * 3L was made for YOU to help you create awesome websites +// * and fill the Internet with excessive amount of Love! ♥ +// * +// * Keep up your good work! +// * +// * Yours faithfully, +// * Mateusz Kocz -> http://radiatingstar.com +// * +// * 3L: -> http://mateuszkocz.github.com/3l +// * +// * Watch 3L on Github: -> https://github.com/mateuszkocz/3l +// * +// * Submit a bug issue: -> https://github.com/mateuszkocz/3l/issues?state=open +// * +// * +// * Licensed under the Apache License v2.0 +// * http://www.apache.org/licenses/LICENSE-2.0 +// * +// * Version: 1.4.0-beta (2012.12.06) +// * +// */ + +///* +// * To compile all of the code you need to use a compiler +// * that supports JavaScript code and guarder mixins. +// * WinLess meets those requirements. You can find it on winless.org +// * +// * If you're on a Mac and your compiler meets the requirements, +// * please, let me know via Twitter or GitHub! +// * +// */ + +///* ACTIVATE SUPPORTING CLASSES */ +///* Uncomment ones you want to use or put them in html or body elements in your style sheet. */ +///* For the explanation what those classes do, read further. */ + + //html { // If you want to use those classes, uncomment also the html element. + //.seo-helper; + //.box-sizing() // Put in the brackets box-model you want to use. + //} // CAUTION! If you're using any of those supporting classes, uncomment that bracket! + +///* +// * SEO & HTML Debugging +// * +// * A useful supporting class that will help a bit with your SEO +// * and usability of your website. +// * +// * Creating a website is a serious business, but sometimes you may +// * forget about some important details. This class will help you. +// * It will let you know when you haven't put an alt attribute on image +// * or kept that attribute empty, when you haven't typed a URL in anchor or when +// * anchor link has rel=nofollow attribute. It will also show you an alert +// * message if you don't have a tag and description or left them empty*. +// * +// * If any of the errors described above happens, according element will +// * get a red outline border drawing your attention and asking for some love +// * or you will get a message with the same purpose. +// * +// * *** * The <title> reminder can alert you even if you have a <title> tag. +// * *** This happens if you have a <link> tag (usually used for style sheets) +// * *** before <title> in your HTML. Just change the order of <link> and +// * *** <title> and you're cool. +// * +// * How to: +// * Place the .seo-helper class in html element. That's it! +// * +// * *** Example: html {.seo-helper} +// * +// * That way every element on your page will be affected +// * by this rule. You can also place it in any other container +// * class element in your code (body, div.wrapper, article and so on) +// * if you don't want for some reasons to check for bugs on whole page +// * but in a single area. +// * +// * Caution! Do not forget to delete this class before finishing your +// * project, unless you want to keep it in continuous project (like blog) +// * and debug every new content on your site. But then you might consider +// * restyling this class to be a bit more eye-pleasing. +// * +// * This may not work in every browser, but since you are a web +// * developer/designer you're probably already using a bleeding +// * edge nightly alpha back-door version of browser, so no problem! +// * It's probably the only class you don't need to care about how +// * your visitors will see it! +// * +// * *** Aside - How it works: +// * *** Section only for people who don't know yet what attribute +// * *** selectors and negation pseudo-class are. +// * *** +// * *** Using negation pseudo-class is like saying "target every element x +// * *** that doesn't have attribute y" or "target every element exept (but 'not') z". +// * *** You can read more about that here ->www.w3.org/TR/selectors/#negation. +// * *** +// * *** Attribute selectors are rules that target elements that have +// * *** some specified attributes (rel, alt, href etc.) and/or specified +// * *** value of this attributes. Read more on this topic here +// * *** ->www.w3.org/TR/selectors/#selectors. +// * +// * For a further explanation and a demo, refer to: +// * -> http://radiatingstar.com/how-to-improve-seo-with-css +// * +// * Why img:not([alt]), img[alt=""] and img[alt^=" "]? +// * First targets images that don't have an alt attribute, second targets +// * ones that have this attribute but it's left empty (probably left by +// * automatic completion of html editor), third is just in case - it +// * might have been left by html editor or manually "to do it later" (clearly +// * a space at the beginning of an alt can't be anything good). +// * +// * Why a[href=""]? +// * If you write an anchor text and leave href to copyPaste URL later, +// * it will reminding you about that. +// * +// * Why a[rel="nofollow"]? +// * For some reasons links on your site may have this attribute and this +// * may generate a huge SEO problem. Better fix it ASAP. (On the other hand +// * nofollow links might be useful in some situations. See here: +// * -> http://en.wikipedia.org/wiki/Nofollow#Control_internal_PageRank_flow) +// * +// * Why div:empty, span:empty, li:empty, p:empty, td:empty, th:empty? +// * It'll just check if you have some redundancy (empty elements) in you code. +// * +// */ + +.seo-helper () { + img:not([alt]), img[alt=""], img[alt^=" "], + a[href=""], a[href^=" "], a[href="#"], a[rel*="nofollow"], + div:empty, span:empty, li:empty, p:empty, td:empty, th:empty, + *[title=""], *[class=""], *[id=""] { + outline: 2px solid red !important; + outline-offset: 3px !important; + } + head, title:empty, link, meta {display: block;} + title:empty:before {content: "You've left the <title> empty!"} + link:before {content: "You don't have a <title>!"} + title ~ link {display: none;} + meta[name="description"][content=""]:before, meta[name="description"][content=" "]:before {content: "You've left description empty!";} + } + +///* +// * Helper classes from HTML5 Boilerplate +// * +// * Classes below help you create a better user experience for both users +// * of browsers and screen readers. Oh, and there's also a clearfix! +// * +// * All the classes comes from HTML5 Boilerplate (-> html5boilerplate.com). Here though, +// * they're changed so that they can be easily used in The LESS Way. +// * They're called "non-semantic" in H5B, but here they become semantic if used well. +// * (Actually they can't be used in any way than good in 3L.) +// * (Actually II they can be semantic in H5B as well, but it's a bit pain to do that.) +// * +// * Usage: +// * Just put them in your classes, id's or elements. +// * +// * Example: +// * .YOUR-AWESOME-CLASS-NAME { +// * // some rules +// * .clearfix; +// * } +// * +// */ + +// For image replacement. +.ir () {border: 0; overflow: hidden; background-color: transparent; *text-indent: -9999px; &:before {content: ""; display: block; width: 0; height: 100%;}} + +// Hide from both screenreaders and browsers: h5bp.com/u +.hidden () {display: none !important; visibility: hidden;} + +// Hide only visually, but have it available for screenreaders: h5bp.com/v +.visuallyhidden () {border: 0;clip: rect(0 0 0 0);height: 1px;margin: -1px;overflow: hidden;padding: 0;position: absolute;width: 1px;} + +// Extends the .visuallyhidden class to allow the element to be focusable when navigated to via the keyboard: h5bp.com/p +// CAUTION! The .visuallyhidden class is included! If you want your object be both +// .visuallyhidden and .focusabe use only .focusable class. +.focusable () {.visuallyhidden;&:active,&:focus{clip: auto; height: auto; margin: 0; overflow: visible; position: static; width: auto;}} + +// Hide visually and from screenreaders, but maintain layout. +.invisible () {visibility: hidden;} + +// Contain floats: h5bp.com/q +.clearfix () {*zoom:1;&:before,&:after{content:" ";display:table;}&:after{clear:both;}} + +///* +// * Some other helper classes. +// */ + +.incomplete() {outline: 3px dotted green} +.fixme() {outline: 3px dotted yellow} +.todo() {outline: 3px dotted blue} +.xxx() {outline: 3px dotted red} + +///* +// * Box-sizing +// * +// * Change the basic box-model to the one you want. +// * +// * Basic box-model defines the width and height of an object only as a size of +// * object's content area. In order to know exactly how big is the object you need +// * to add its padding and borders. This may result in many unwanted behaviours. +// * That's why you can define how you want the browser to calculate the width/height: +// * with or without padding, with or without borders. +// * +// * To use this feature just put a value you want: +// * -- content-box ("content" works too) - it's default value from basic model. +// * -- padding-box (also "padding") - width and height declarations will include paddings. +// * -- border-box (and "border") - border and padding included. +// * +// * Usage: +// * 1. .box-sizing(content-box), .box-sizing(content) and .content-box-sizing* for box-sizing: content-box. +// * 2. .box-sizing(padding-box), .box-sizing(padding) and .padding-box-sizing* for box-sizing: padding-box. +// * 3. .box-sizing(border-box), .box-sizing(padding) and .border.box-sizing* for box-sizing: border-box. +// * +// * * Beware not to use those properties without -sizing suffix thus suffixless classes are for background-clip (see this class below). +// * +// * Resources: +// * -- http://paulirish.com/2012/box-sizing-border-box-ftw/ +// * +// * Browsers support: IE8+ and every other. +// * Notable lack of support: IE7- +// * +// */ + +.content-box-sizing(){-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box;} +.padding-box-sizing(){-moz-box-sizing:padding-box;-webkit-box-sizing:padding-box;box-sizing:padding-box;} +.border-box-sizing(){-moz-box-sizing:border-box;-webkit-box-sizing:border-box;box-sizing:border-box;} +.box-sizing (padding) {.padding-box-sizing;} +.box-sizing (padding-box){.padding-box-sizing;} +.box-sizing (border){.border-box-sizing;} +.box-sizing (border-box){.border-box-sizing;} +.box-sizing (content){.content-box-sizing;} +.box-sizing (content-box){.content-box-sizing;} + +///* +// * Background-clip +// * +// * Clips the object's background to the desired box according to the box-model. +// * +// * To use this class simply put into an object a .background-clip(box) class, +// * where box means the desired box (see below). You can also use a shorter class +// * .bg-clip or class that corresponds to the clipping you want to get (.content-clip, +// * .padding-clip, .border-clip). +// * +// * Arguments that comes into (box) are: +// * -- content-box or content for content clip, +// * -- padding-box or padding for padding clip, +// * -- border-box or border for border clip. +// * *** You can use values either with or without "-box" suffix. +// * +// * Browsers support: IE9+ and every other. +// * Notable lack of support: IE8- +// * +// */ + +.content-box(){-moz-background-clip:content;background-clip:content-box;} +.padding-box(){-moz-background-clip:padding;background-clip:padding-box;} +.border-box(){-moz-background-clip:border;background-clip:border-box;} +.background-clip (padding){.padding-box;} +.background-clip (padding-box){.padding-box;} +.background-clip (border){.border-box;} +.background-clip (border-box){.border-box;} +.background-clip (content){.content-box;} +.background-clip (content-box){.content-box;} +.bg-clip(@arguments){.background-clip(@arguments);} + +///* +// * Box-shadow +// * Create a shadow behind or inside the element. +// * +// * Usage: +// * In .box-shadow() brackets put arguments for every single shadow. Separate +// * each shadows' arguments with comma. You can put up to five shadows +// * by default but feel free to add a class with as many as you want. +// * Just check how it is done. +// * +// * You can use a default box-shadow which will create a shadow with +// * 0px x and 1px y offsets, 3px of blur and in black colour with 25% transparency. +// * Just place a .box-shadow class without any arguments. +// * +// * Box-shadow property takes following arguments: +// * +// * 1. inset [optional]. +// * 2. x-offset [required]. +// * 3. y-offset [required]. +// * 4. blur [optional]. +// * 5. spread [optional]. +// * 6. color [optional/required]. +// * +// * Resources: +// * -- developer.mozilla.org/en/CSS/box-shadow +// * +// * Browsers support: IE9, Fx3.5, Chrome, Opera, Safari, Opera Mobile, Android Browser +// * Notable lack of support: IE8-, Opera Mini +// * +// * Example: +// * Two box-shadows: one is 1px offset, black, second one is green with 30% opacity, inset, +// * with 5px offsets, 3px of blur and 1px spread. +// * .box-shadow(1px 1px black, inset 5px 5px 3px 1px fade(green,30%)) // fade(colour,XX%) is a LESS native function +// * // that adds alpha channel to colour. Instead of fade() +// * // you can also use rgba or hsla colours declaration. +// * Solution for multiple box-shadows in a single mixin taken from http://www.toekneestuck.com/blog/2012/05/15/less-css-arguments-variable/ +// */ + +.box-shadow(@shadow1, @shadow2:X, ...){ + @shadows: ~`"@{arguments}".replace(/[\[\]]|\,\sX/g, '')`; + -webkit-box-shadow: @shadows; + -moz-box-shadow: @shadows; + -o-box-shadow: @shadows; + box-shadow: @shadows; +} + +///* +// * Border-radius +// * Round the element's corners. +// * +// * Usage: +// * Border-radius property takes one to four arguments with px, em and % +// * values and round the element's corners accordingly. You can make +// * ellipticaly roundeded corners putting two sets of values separated with +// * comma using .elliptical-border-radius class. In order to round a single +// * corner use .round-corner class. This class takes two sets of arguments. +// * First one is a declaration of corner you want to round (top-left, top-right, +// * bottom-right, bottom-left), second one (separated from the first with comma), +// * is a set of values in px, em or % that round choosen corner. Second +// * declaration can have one (for circle rounding) or two values (for +// * elliptical rounding). +// * +// * For further explanation of the border-radius property, refer to the +// * resources section above. +// * +// * Resources: +// * -- developer.mozilla.org/en/CSS/border-radius +// * +// * Browsers support: IE9, Fx3.5, Chrome, Opera, Safari, Opera Mobile, Android Browser +// * Notable lack of support: IE8-, Opera Mini +// * +// * Example: +// * 1. Round every corner of the element with 10px radius. +// * .border-radius(10px) +// * 2. Round top-left and bottom-right corners by 10px, top-right +// * and bottom-left corners by 20px. +// * .border-radius(10px 20px) +// * 3 Exemplary use of the .elliptical-border-radius class. +// * .elliptical-border-radius(10px 20px 30px, 40px 50px 60px 70px) +// * 4. Round top-right corner by 10px and 20px (elliptical). +// * .round-corner(top-right, 10px 20px) +// * .border-top-right-radius(10px 20px) // Alternate method. +// * 5. Round similar corners. +// * .border-top-radius(20px 10px); // top-left + top-right (elliptical) +// * .border-left-radius(5px); // top-left + bottom-left +// * +// */ + +// If your rounded corners looks bad with borders add this class to your rounded element. +// -> http://tumble.sneak.co.nz/post/928998513/fixing-the-background-bleed +.border-radius-fix(){.background-clip(padding-box);} + +.border-radius (@radius:5px, ...) { + -webkit-border-radius: @arguments; + -moz-border-radius: @arguments; + border-radius: @arguments; +} +// Alternate name for .border-radius. +.round-corners (@radius:5px, ...) {.border-radius(@arguments);} + +.elliptical-border-radius (@radius1, @radius2) { + -webkit-border-radius: @radius1 ~"/" @radius2; + -moz-border-radius: @radius1 ~"/" @radius2; + border-radius: @radius1 ~"/" @radius2; +} +.round-corner (top-left, @radius...){ + -webkit-border-top-left-radius: @radius; + -moz-border-top-left-radius: @radius; + border-top-left-radius: @radius; +} +.round-corner (top-right, @radius...){ + -webkit-border-top-right-radius: @radius; + -moz-border-top-right-radius: @radius; + border-top-right-radius: @radius; +} +.round-corner (bottom-right, @radius...) { + -webkit-border-bottom-right-radius: @radius; + -moz-border-bottom-right-radius: @radius; + border-bottom-right-radius: @radius; +} +.round-corner (bottom-left, @radius...) { + -webkit-border-bottom-left-radius: @radius; + -moz-border-bottom-left-radius: @radius; + border-bottom-left-radius: @radius; +} +// Another methods to use corner radius. +.border-top-left-radius (...) {.round-corner(top-left,@arguments);} +.border-top-right-radius (...) {.round-corner(top-right,@arguments);} +.border-bottom-right-radius (...) {.round-corner(bottom-right,@arguments);} +.border-bottom-left-radius (...) {.round-corner(bottom-left,@arguments);} + +// Round similar corners. +.border-top-radius (...) {.round-corner(top-left,@arguments);.round-corner(top-right,@arguments);} +.border-bottom-radius (...) {.round-corner(bottom-left,@arguments);.round-corner(bottom-right,@arguments);} +.border-left-radius (...) {.round-corner(top-left,@arguments);.round-corner(bottom-left,@arguments);} +.border-right-radius (...) {.round-corner(top-right,@arguments);.round-corner(bottom-right,@arguments);} + +// Another classes for the same purpose as above. +.round-top-corners (...) {.border-top-radius(@arguments);} +.round-bottom-corners (...) {.border-bottom-radius(@arguments);} +.round-left-corners (...) {.border-left-radius(@arguments);} +.round-right-corners (...) {.border-right-radius(@arguments);} + +///* +// * Opacity +// * Make an object transparent. +// * +// * Opacity takes values between 0.0 (invisible) to 1.0 (default - full +// * visibility) but 3L lets you also use percentages and values from >1 to 100. +// * +// * If you want an element with transparency 1, .5 or 0, use these classes: +// * .not-transparent., .half-transparent, .transparent. +// * +// * Browsers support: full (IE6+) +// * Caution! According to -> caniuse.com/#search=opacity, transparency doesn't +// * work well with PNG images that are itself transparent (use alpha channel) in IE8-. +// * +// * Aside: +// * Do we need the ability to set opacity in numbers from 1 to 100 +// * and in percentages? I think we do, because: +// * 1. You need to use integer numbers in filter property for IE, +// * so there is a possibility that someone will type this kind +// * of value, instead of [0,1]. +// * 2. LESS has a fade() function that uses percentages to makes +// * colours (semi)transparent, so using percentages here will +// * result in more consistent code (same unit in similar situation). +// * 3. Percentages are more intuitive when it comes to transparency and +// * opacity since graphic editors like Photoshop and GIMP use them. +// * +// */ + +.transparent() {.opacity(0);} +.non-transparent() {.opacity(1);} +.half-transparent () {.opacity(.5);} +.opacity () {.non-transparent();} +.opacity (@value) when (isnumber(@value)) and (@value =< 1){ + opacity: @value; + filter: ~"alpha(opacity="@value*100~")"; + } +.opacity (@value) when (isnumber(@value)) and (@value > 1) and not (ispercentage(@value)){ + // INFO: for the explanation of rule "and not (ispercentage(@value))" refer to the class below. + opacity: @value/100; + filter: ~"alpha(opacity="@value~")"; + } +.opacity (@value) when (ispercentage(@value)) { + // Change the @value from percentage to integer (XX% => XX) + @integerValue: `parseInt('@{value}')`; + // Actually the @value should be a number now... but it isn't. + // LESS think of it as a string so we can't do math here. + // We'll use a feature of LESS that automatically makes + // a second value's unit in a sum to be the same as the first one. + // In our case we need a number so we can divide it by 100. + opacity: (0 + @integerValue) /100; + // We don't need a math in filter so no trick. + filter: ~"alpha(opacity="@integerValue~")"; + + // BUG: WinLESS compile this with doubled properties unless the rule + // "and not (ispercentage(@value))" is added in the class above. + // In Firebug (through the LESS native compiler) those properties + // aren't doubled, though. + } + +///* +// * Gradient +// * Create a beautiful gradient without images. +// * +// * Pick a type of a gradient you want to have and put colours in +// * brackets. You can put either two or three colours. In the first case +// * the default colour for old browsers will be the same as the first colour provided. +// * In the second case you can set that colour as a third argument. +// * +// * The default class - .gradient - is the same as .vertical-gradient. +// * +// * You can choose from four types of gradients: +// * 1. Vertical - colour will change from top to bottom. +// * 2. Horizontal - change is from left to right. +// * 3. Diagonal - from top-left to bottom-right. +// * 4. Radial - from the centre of an element to its borders. +// * +// * Gradients tend to be tricky. There's no support for this property +// * in older IE, but "filter" comes to the rescue. It can generate +// * only horizontal and vertical gradients, though. Also IE9 has some +// * strange behaviour -> css3wizardry.com/2010/10/29/css-gradients-for-ie9/. +// * To provide the best experience for your visitors you should use +// * gradient generator (refer to resources above) with "IE9 Support" option checked. +// * +// * Resources: +// * -- gradient generator with broad browsers support and some advanced options: +// * -> www.colorzilla.com/gradient-editor/ +// * -- gradient is a powerful tool - you can generate shapes as a background! +// * -> lea.verou.me/css3patterns/ +// * +// * Browsers support: almost full +// * Notable lack of support: Opera mini +// * Caution! IE6 - IE8 use filter property that can generate only vertical and +// * horizontal gradients. For the best experience in IE9 use gradient generator +// * mentioned above in the resources. +// * +// * TODO: manual for .gradient(). Mention it's still compatible with previous versions of 3L since +// * you need to provide at least 4 values to use it. Anything less will use the old .gradient(). +// * You can provide as much stop colors as you want. +// */ + +// Multi-purpose gradient is in a BETA stage! Uncomment for your own responsibility. +///* +// * FIXME: you don't need to provide the @direction value since default is "to bottom". How to make it works? +// * FIXME: simple radial-gradient should work, but what if you provide some more advanced values? +// * FIXME: does it work with "to top left" and similar or angles? +// */ +// .gradient(@gradientType, @direction, @rest...) { + // @valuesProcessed: ~`"@{rest}".replace(/[\[\]]/g, '')`; + // @directionProcessedOld: ~`"@{direction}".replace(/[\[\]]|\,/g,'').replace("to ","").replace("top","bottom").replace("bottom","top").replace("right","left").replace("left","right").replace("at ","").replace("cover", "farthest-corner")`; + // @directionProcessedNew: ~`"@{direction}".replace(/[\[\]]|\,/g,'')`; +// + // @webkit1: `"-webkit-" + "@{gradientType}" + "-gradient(" + "@{directionProcessedOld}," + "@{valuesProcessed}" + ")"`; + // @webkit2: ~`'@{webkit1}'.replace(/\"/g, '')`; + // background-image: @webkit2; +// + // @moz1: `"-moz-" + "@{gradientType}" + "-gradient(" + "@{directionProcessedOld}," + "@{valuesProcessed}" + ")"`; + // @moz2: ~`'@{moz1}'.replace(/\"/g, '')`; + // background-image: @moz2; +// + // @o1: `"-o-" + "@{gradientType}" + "-gradient(" + "@{directionProcessedOld}," + "@{valuesProcessed}" + ")"`; + // @o2: ~`'@{o1}'.replace(/\"/g, '')`; + // background-image: @o2; +// + // @w3c1: `"@{gradientType}" + "-gradient(" + "@{directionProcessedNew}," + "@{valuesProcessed}" + ")"`; + // @w3c2: ~`'@{w3c1}'.replace(/\"/g, '')`; + // background-image: @w3c2; +// } + +.gradient (@color1, @color2){ + background: @color1; + background-image: -moz-linear-gradient(top, @color1 0%, @color2 100%); + background-image: -webkit-linear-gradient(top, @color1 0%,@color2 100%); + background-image: -o-linear-gradient(top, @color1 0%,@color2 100%); + background-image: linear-gradient(to bottom, @color1 0%,@color2 100%); + filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='@{color1}', endColorstr='@{color2}',GradientType=0 ); +} + + +.gradient (@color1, @color2, @color3){ + background: @color3; + background-image: -moz-linear-gradient(top, @color1 0%, @color2 100%); + background-image: -webkit-linear-gradient(top, @color1 0%,@color2 100%); + background-image: -o-linear-gradient(top, @color1 0%,@color2 100%); + background-image: linear-gradient(to bottom, @color1 0%,@color2 100%); + filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='@{color1}', endColorstr='@{color2}',GradientType=0 ); +} +// .vertical-gradient = .gradient +.vertical-gradient (@color1,@color2) {.gradient(@color1,@color2)} +.vertical-gradient (@color1,@color2,@color3) {.gradient(@color1,@color2,@color3)} +.horizontal-gradient (@color1, @color2) { + background: @color1; + background-image: -moz-linear-gradient(left, @color1 0%, @color2 100%); + background-image: -webkit-linear-gradient(left, @color1 0%,@color2 100%); + background-image: -o-linear-gradient(left, @color1 0%,@color2 100%); + background-image: linear-gradient(to right, @color1 0%,@color2 100%); + filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='@{color1}', endColorstr='@{color2}',GradientType=1 ); +} +.horizontal-gradient (@color1, @color2, @color3) { + background: @color3; + background-image: -moz-linear-gradient(left, @color1 0%, @color2 100%); + background-image: -webkit-linear-gradient(left, @color1 0%,@color2 100%); + background-image: -o-linear-gradient(left, @color1 0%,@color2 100%); + background-image: linear-gradient(to right, @color1 0%,@color2 100%); + filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='@{color1}', endColorstr='@{color2}',GradientType=1 ); +} +.diagonal-gradient (@color1, @color2) { + background: @color1; + background-image: -moz-linear-gradient(-45deg, @color1 0%, @color2 100%); + background-image: -webkit-linear-gradient(-45deg, @color1 0%,@color2 100%); + background-image: -o-linear-gradient(-45deg, @color1 0%,@color2 100%); + background-image: linear-gradient(135deg, @color1 0%,@color2 100%); + filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='@{color1}', endColorstr='@{color2}',GradientType=1 ); + } +.diagonal-gradient (@color1, @color2,@color3) { + background: @color3; + background-image: -moz-linear-gradient(-45deg, @color1 0%, @color2 100%); + background-image: -webkit-linear-gradient(-45deg, @color1 0%,@color2 100%); + background-image: -o-linear-gradient(-45deg, @color1 0%,@color2 100%); + background-image: linear-gradient(135deg, @color1 0%,@color2 100%); + filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='@{color1}', endColorstr='@{color2}',GradientType=1 ); + } +.radial-gradient (@color1, @color2) { + background: @color1; + background-image: -moz-radial-gradient(center, @color1 0%, @color2 100%); + background-image: -webkit-radial-gradient(center, @color1 0%,@color2 100%); + background-image: -o-radial-gradient(center, @color1 0%,@color2 100%); + background-image: radial-gradient(at center, @color1 0%,@color2 100%); + filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='@{color1}', endColorstr='@{color2}',GradientType=1 ); + } +.radial-gradient (@color1, @color2,@color3) { + background: @color3; + background-image: -moz-radial-gradient(center, @color1 0%, @color2 100%); + background-image: -webkit-radial-gradient(center, @color1 0%,@color2 100%); + background-image: -o-radial-gradient(center, @color1 0%,@color2 100%); + background-image: radial-gradient(at center, @color1 0%,@color2 100%); + filter: progid:DXImageTransform.Microsoft.gradient( startColorstr='@{color1}', endColorstr='@{color2}',GradientType=1 ); + } + +///* +// * Background-size +// * Scale (or not) your background image. +// * +// * This property takes following values: +// * -- auto [default] - it does nothing when used alone; when used with a value +// * it makes sure that image will keep its aspect ratio while being stretched +// * to the required size. (See: examples 3. and 4.) +// * -- contain - scale image to the first border it meets; +// * it may leave some area uncovered but keeps image's aspect ratio, +// * -- cover - scale image to the second border it meets; +// * cover all area but part of an image may not be shown. The image keeps its aspect ratio. +// * -- px, em, % - scale image according to declared value; +// * you can declare one value (x-size) or two values for each size. +// * Using (100%, 100%) stretch the image to cover full area but may not +// * keep its aspect ratio. When you use percentages keep in mind that XX% +// * means XX% of the element size, not XX% of the background image. +// * +// * Consider adding background-repeat property to avoid unwanted repetition of background. +// * +// * Browsers support: IE9+, Fx3.6+, Chrome, Safari, Opera, Opera Mini, Opera Mobile, Android Browser +// * Notable lack of support: IE8- +// * +// * Examples: +// * 1. .background-size(contain); +// * 2. .background-size(cover); +// * 3. .background-size(70%); // = (70% auto). Image is scaled to take 70% of width +// * // of the element and it keeps its own aspect ratio. +// * 4. .background-size(auto, 70%) // Image is scaled to take 70% of element's +// * // height and keeps aspect ratio. +// * 5. background-size(70px 7em); // Size of the background image is now 70px (width) x 7em (height). +// * 6. background-size(70px,7em); // Same as above. Comma is fine too. +// * +// */ + +.background-size (...) { + -moz-background-size: @arguments; + background-size: @arguments; + } +// A shorthand class. +.bg-size (...) {.background-size(@arguments)} + +///* +// * Columns layout +// * +// * Divide a block of text into columns as seen in newspapers. +// * +// * Basic usage: +// * Use .columns() class providing in brackets arguments for columns. +// * Non of those arguments are required, but unless you provide one, columns +// * layout won't work. Available arguments: +// * -- integer - declare a column-count. Unless declared, their width will +// * equal to division of the block's width minus column-gaps and declared integer. +// * Default value is "auto" which means that width of columns will be determined +// * by column-width value. +// * -- width - declare every column width in px, em and % (of containing block). +// * Default value is "auto" - column width will be equal to division of the +// * block's width and declared column-count +// * +// * Usage of supporting classes: +// * You can declare the gaps between columns by .column-gap() class that takes +// * width type argument. Default value is "normal" and equals to 1em. +// * +// * Declare a vertical rule between columns using .column-rule(). It's the same +// * type of declaration as in borders, that is width, style and colour. By default +// * there is no rule. +// * +// * Browsers support: IE10+, Fx, Chrome, Safari, Opera, Opera Mobile, Android Browser +// * Notable lack of support: IE9-, Opera Mini +// * +// * Example: +// * 1. .column(2, 20px) // Two columns with 20px width. +// * 2. .column(5) // Five columns layout. +// * 3. element { +// * .column(100px); // A 100px width columns +// * .column-gap(10px); // with 10px gap between +// * .column-rule(1px solid black); // and 1px thick, solid, black vertical rule. +// * } +// * +// */ + +.columns (...) { + -webkit-columns: @arguments; + -moz-columns: @arguments; + columns: @arguments; + } +.column-gap (@gap) { + -webkit-column-gap: @gap; + -moz-column-gap: @gap; + column-gap: @gap; + } +.columns-gap (@gap) {.column-gap(@gap);} +.column-rule (...) { + -webkit-column-rule: @arguments; + -moz-column-rule: @arguments; + column-rule: @arguments; + } +.columns-rule (...) {.column-rule(@arguments);} +.column-fill (@fill) { + -webkit-column-fill: @fill; + -moz-column-fill: @fill; + column-fill: @fill; +} +.columns-fill (@fill) {.column-fill(@fill);} + +///* +// * Transform +// * 2D and 3D transformation of an object. +// * +// * You can use classes dedicated to specifics transformation, but if you plan +// * to use multiple transformation on an object, use general classes .transform +// * or .transform3d instead. Otherwise the latter transform will override the former. +// * If you want to use some of the 3D transformations, use .transform3d class. It +// * has a 3D specific property transform-style included. You can put both 3D and 2D +// * transformations in .transform3D. +// * +// * Transforms don't affect an object's place in a document and its environment +// * so there's no risk of crashing a layout. +// * +// * Transformations characteristics: +// * -- Rotate takes one argument and rotate object clockwise by specified angle (in deg). +// * -- Scale takes one or two arguments (x,y). If y is not specified it is assumed that x = y. +// * Arguments in interval (0,1) shrink the object. Arguments >1 makes it bigger. +// * -- Skew takes one or two arguments (x,y). If y is not specified it is assumed that y = 0 (no y-skew). +// * Arguments must be in deg. +// * -- Translate takes one or two arguments (w,y). If y is not specified it is assumed y = 0 (no y-translate). +// * Arguments are in px or em. Translate moves the object by specified value. +// * +// * Sometimes you might want to control the point that is the relative base of transformations. +// * For that reason use .transform-origin class. That class takes one or two values. +// * First value defines horizontal position of that point, second refers to vertical position. +// * In case you provide only the first value, the second is set to 50%. Default value is (50% 50%). +// * You can use three types of values: +// * -- pixels that place origin point in position according to the top-left corner of an element +// * to its bottom-right corner. Negative values allowed - in that case position goes to the left +// * and top from the top-left corner, +// * -- percentages that are relative to object's width and height. As in px, the original position +// * is top-left corner (0% 0%), and goes to bottom-right (100% 100%). Negative values does the +// * same as in px. +// * -- keywords: left / center / right for x-axis and top / center / bottom for y-axis. +// * +// * For 3D transformations you can set a perspective using .perspective() class and putting +// * value in brackets . +// * +// * Browsers support: IE9+, Fx3,5+, Chrome, Safari, Opera, Opera Mobile, Android Browser +// * Notable lack of support: IE8-*, Opera Mini +// * * You can use some of the transformation in older IE through filter property. +// * To generate that property refer to -> css3please.com. +// * You can also emulate scale property with zoom property. +// * +// * Examples: +// * 1. .scale(2,.5) // Stretch an object two times and shrink in height by half. +// * 2. .rotate(180deg) // Rotate an object by 180deg. +// * 3. .transform(.scale(2,.5),rotate(180deg)) // Does the combined transformation from examples above. +// * 4. .transform-origin(20% top) // Place the transformation origin at the top, 20% of the object's +// * // width to the right from the top-left corner. +// */ + +.transform-origin (...) { + -webkit-transform-origin: @arguments; + -moz-transform-origin: @arguments; + -ms-transform-origin: @arguments; + -o-transform-origin: @arguments; + transform-origin: @arguments; + } +.perspective (...) { + -webkit-perspective: @arguments; + -moz-perspective: @arguments; + -o-perspective: @arguments; + perspective: @arguments; + } +.backface-visibility(@visibility){ + -webkit-backface-visibility: @visibility; + backface-visibility: @visibility; +} +.transform (...) { + -webkit-transform: @arguments; + -moz-transform: @arguments; + -ms-transform: @arguments; + -o-transform: @arguments; + transform: @arguments; + } +.transform3d (...) { + -webkit-transform: @arguments; + -webkit-transform-style: preserve-3d; + -moz-transform: @arguments; + -moz-transform-style: preserve-3d; + -o-transform: @arguments; + -o-transform-style: preserve-3d; + transform: @arguments; + transform-style: preserve-3d; +} +.rotate (@rotate) { + -webkit-transform: rotate(@rotate); + -moz-transform: rotate(@rotate); + -ms-transform: rotate(@rotate); + -o-transform: rotate(@rotate); + transform: rotate(@rotate); + } +.rotate3d (@deg1, @deg2:0, @deg3:0){ + -webkit-transform: rotateX(@deg1) rotateY(@deg2) rotateZ(@deg3); + -webkit-transform-style: preserve-3d; + -moz-transform: rotateX(@deg1) rotateY(@deg2) rotateZ(@deg3); + -moz-transform-style: preserve-3d; + -o-transform: rotateX(@deg1) rotateY(@deg2) rotateZ(@deg3); + -o-transform-style: preserve-3d; + transform: rotateX(@deg1) rotateY(@deg2) rotateZ(@deg3); + transform-style: preserve-3d; + } +.scale (@scale) { + -webkit-transform: scale(@scale); + -moz-transform: scale(@scale); + -ms-transform: scale(@scale); + -o-transform: scale(@scale); + transform: scale(@scale); + } +.scale (@scale1,@scale2) { + -webkit-transform: scale(@scale1,@scale2); + -moz-transform: scale(@scale1,@scale2); + -ms-transform: scale(@scale1,@scale2); + -o-transform: scale(@scale1,@scale2); + transform: scale(@scale1,@scale2); + } +.scaleX (@scale) { + -webkit-transform: scaleX(@scale); + -moz-transform: scaleX(@scale); + -ms-transform: scaleX(@scale); + -o-transform: scaleX(@scale); + transform: scaleX(@scale); + } +.scaleY (@scale) { + -webkit-transform: scaleY(@scale); + -moz-transform: scaleY(@scale); + -ms-transform: scaleY(@scale); + -o-transform: scaleY(@scale); + transform: scaleY(@scale); + } +.skew (@skew) { + .skewX(@skew); + } +.skew (@skew1, @skew2) { + -webkit-transform: skewX(@skew1) skewY(@skew2); + -moz-transform: skewX(@skew1) skewY(@skew2); + -ms-transform: skewX(@skew1) skewY(@skew2); + -o-transform: skewX(@skew1) skewY(@skew2); + transform: skewX(@skew1) skewY(@skew2); + } +.skewX (@skew) { + -webkit-transform: skewX(@skew); + -moz-transform: skewX(@skew); + -ms-transform: skewX(@skew); + -o-transform: skewX(@skew); + transform: skewX(@skew); + } +.skewY (@skew) { + -webkit-transform: skewY(@skew); + -moz-transform: skewY(@skew); + -ms-transform: skewY(@skew); + -o-transform: skewY(@skew); + transform: skewY(@skew); + } +.translate (@translate) { + -webkit-transform: translate(@translate); + -moz-transform: translate(@translate); + -ms-transform: translate(@translate); + -o-transform: translate(@translate); + transform: translate(@translate); + } +.translate (@translate1, @translate2) { + -webkit-transform: translate(@translate1, @translate2); + -moz-transform: translate(@translate1, @translate2); + -ms-transform: translate(@translate1, @translate2); + -o-transform: translate(@translate1, @translate2); + transform: translate(@translate1, @translate2); + } +.translateX (@translate) { + -webkit-transform: translateX(@translate); + -moz-transform: translateX(@translate); + -ms-transform: translateX(@translate); + -o-transform: translateX(@translate); + transform: translateX(@translate); + } +.translateY (@translate) { + -webkit-transform: translateY(@translate); + -moz-transform: translateY(@translate); + -ms-transform: translateY(@translate); + -o-transform: translateY(@translate); + transform: translateY(@translate); + } + +///* +// * Transition +// * Animate a change between different object states. +// * +// * You can use this class to animate change of up to 5 different properties. +// * If you need more that that (wow!) it's easy to add more of these classes. +// * +// * Transition takes 4 values: +// * -- transition-property - choose a property you want to animate (margin, colour etc.). +// * Default value is "all" which will animate every change that might happen. It's a good +// * idea to explicitly write this value if you want to animate everything, though. We can't +// * be sure if in the future default state won't change to "none", which will break the whole transition. +// * -- transition-duration - specifies how long transition animation will have to take +// * until animation is finished. Put values in s (seconds) or ms (milliseconds). +// * Required value, since default state is 0s (no animation occurs). +// * -- transition-timing-function - this value describe an acceleration function. It can +// * really affect overall experience, so it's good idea to pay attention to that. +// * Timing function takes 4 number values of keywords: linear, ease, ease-in, +// * ease-in-out, ease-out. For further explanation refer to ->developer.mozilla.org/en/CSS/timing-function +// * Default value is "ease". +// * -- transition-delay - in seconds or millisecond describes how long transition will wait +// * until it occurs after a triggering requirement was met. Default value is 0 - instant animation. +// * +// * In case you want to put a transformation property into transition effect, use +// * the .transition-transform class. This class is prepared to automatically add +// * many browsers prefixes required in that case. It is also a bit future friendly, +// * but all at all using transitions on transform is very risky. +// * -> http://radiatingstar.com/transition-with-transform-cant-be-future-proof +// * +// * Usage: +// * For .transition class, put in brackets at least a time value. If you want to animate more than one +// * property or animate everything with different functions, put up to 5 declarations separated with +// * commas. If one of the property you want to animate is "transform" _and_ you want to animate every +// * other properties (or at least not with the same functions), use .transition-transform. As a first +// * value put a time duration for transform property. Do not write this property though. It's auto-added +// * for the first set of values. Add other properties after commas. Refer to the example 3. +// * +// * Browsers support: IE10+, Fx4+, Chrome, Opera, Safari, Opera Mobile, Android Browser +// * Notable lack of support: IE9-, Fx3.6-, Opera Mini +// * *** Transition provides only a visual effects between states. It's perfectly +// * *** safe to use. Users with older browser just won't see a phase of changing. +// * +// * Examples: +// * 1. .transition (all 1s); // Animate all properties for 1 second. +// * 2. .transition (background-color 5s, margin 1s linear 5s) // Animate change of background-color for 5s +// * // and after 5s animate margin change for 1s. +// * 3. .transition-transform (2s linear, padding 3s) // Animate change of transform property (no "transform" declared!) +// * // and padding property. +// * +// * Solution for multiple transitions in a single mixin taken from http://www.toekneestuck.com/blog/2012/05/15/less-css-arguments-variable/ +// */ + +.transition(@transition1, @transition2:X, ...){ + @transitions: ~`"@{arguments}".replace(/[\[\]]|\,\sX/g, '')`; + -webkit-transition: @transitions; + -moz-transition: @transitions; + -o-transition: @transitions; + transition: @transitions; +} +.transition-transform (@transformArguments1, @transformArguments2:X, ...) { + @transformArguments: ~`"@{arguments}".replace(/[\[\]]|\,\sX/g, '')`; + -webkit-transition: -webkit-transform @transformArguments; + -moz-transition: -moz-transform @transformArguments; + -o-transition: -o-transform @transformArguments; + transition: transform @transformArguments; +} +// FIXME: The specyfic properties also require the unlimited arguments feature. +.transition-property(...) { + -webkit-transition-property: @arguments; + -moz-transition-property: @arguments; + -o-transition-property: @arguments; + transition-property: @arguments; +} +.transition-duration(...) { + -webkit-transition-duration: @arguments; + -moz-transition-duration: @arguments; + -o-transition-duration: @arguments; + transition-duration: @arguments; +} +.transition-timing-function(...) { + -webkit-transition-timing-function: @arguments; + -moz-transition-timing-function: @arguments; + -o-transition-timing-function: @arguments; + transition-timing-function: @arguments; +} +.transition-delay(...) { + -webkit-transition-delay: @arguments; + -moz-transition-delay: @arguments; + -o-transition-delay: @arguments; + transition-delay: @arguments; +} + +///* +// * Animations +// * +// * Create an awesome animation! +// * +// * This class takes from two to five properties: +// * -- animation-name [required] - declare your @keyframes animation name. See below +// * for an easy way to make @keyframes! +// * -- animation-duration [required] - declare how long will it take for an animation +// * to reach end. Value in seconds (s) or milliseconds (ms). +// * -- timing-function - it's the same property as in transition. Refer to +// * that topic for further explanation. +// * -- iteration-count - how many times an animation will repeat. It takes integer +// * or "infinite" keyword (for infinite repetition). Default value is 1. +// * -- direction - indicates whether the animation should play in reverse on +// * alternate cycles. Refer to ->developer.mozilla.org/en/CSS/animation-direction +// * for better explanation. To declare a direction use normal [default value], +// * alternate, reverse or alternate-reverse keyword. +// * +// * Resources: +// * -- developer.mozilla.org/en/CSS/animation +// * +// * Creating @keyframes: +// * Write in your .less file: +// * *** @import 'animationX.less'; +// * where X stands for a number between 1 and 5. Then create a class +// * *** .animationX () {} +// * and in {} write declarations you normally write in @keyframes. +// * Then just put an .animation(animationX [other animation properties]) class in your element. +// * That's all! +// * +// * Example: +// * .toBeAnimated { +// * // Animation with every possible value declared. // +// * .animation(animation1 5s linear 3s infinite alternate); +// * } +// * // Importing prefixed @keyframes for animation1. +// * @import '3L/assets/animations/animation1'; +// * +// * // Declaring @keyframes for animation. Only once! +// * .animation1() { +// * from {margin-top: 3px;} +// * to {margin-top: 333px;} +// * } +// * +// */ + +.animation (...) { + -webkit-animation: @arguments; + -moz-animation: @arguments; + -o-animation: @arguments; + animation: @arguments; + } +.animate (...) {.animation(@arguments);} +.anime (...) {.animation(@arguments);} +// FIXME: The specyfic properties also require the unlimited arguments feature. +.animation-name(...) { + -webkit-animation-name: @arguments; + -moz-animation-name: @arguments; + -o-animation-name: @arguments; + animation-name: @arguments; +} +.animation-duration(...) { + -webkit-animation-duration: @arguments; + -moz-animation-duration: @arguments; + -o-animation-duration: @arguments; + animation-duration: @arguments; +} +.animation-timing-function(...) { + -webkit-animation-timing-function: @arguments; + -moz-animation-timing-function: @arguments; + -o-animation-timing-function: @arguments; + animation-timing-function: @arguments; +} +.animation-delay(...) { + -webkit-animation-delay: @arguments; + -moz-animation-delay: @arguments; + -o-animation-delay: @arguments; + animation-delay: @arguments; +} +.animation-iteration-count(...) { + -webkit-animation-iteration-count: @arguments; + -moz-animation-iteration-count: @arguments; + -o-animation-iteration-count: @arguments; + animation-iteration-count: @arguments; +} +.animation-direction(...) { + -webkit-animation-direction: @arguments; + -moz-animation-direction: @arguments; + -o-animation-direction: @arguments; + animation-direction: @arguments; +} +.animation-fill-mode(...) { + -webkit-animation-fill-mode: @arguments; + -moz-animation-fill-mode: @arguments; + -o-animation-fill-mode: @arguments; + animation-fill-mode: @arguments; +} + +///* +// * User-select +// * controls the selection model and granularity of an element. +// * +// * This property takes following values: +// * -- none - none of the element's content can be selected. +// * -- text [default] - the element's contents follow a standard text content selection model. +// * -- toggle - the element's contents follow a standard toggling content model. +// * -- element - one element at a time may be selected. +// * -- elements - one or more elements at a time may be selected. +// * -- all - Only the entire contents as a whole can be selected. +// * +// * Browsers support: IE10+, Fx0.6+, Chrome, Safari +// * Notable lack of support: IE9-, Opera +// * +// */ + +.user-select (...) { +-webkit-touch-callout: @arguments; +-webkit-user-select: @arguments; +-khtml-user-select: @arguments; +-moz-user-select: @arguments; +-ms-user-select: @arguments; +user-select: @arguments; +} + +///* +// * Filter +// * +// * Advanced image manipulation in your CSS! +// * +// * Note: the filter property works only in Webkit for now. Will the prefixed version for other +// * vendors be supported, is unknown, so the mixin might for now generate useles code. +// * You might want to use just the -webkit-filter property without the help of .filter() mixin. +// * +// * drop-shadow and opacity might be hardware accelerated. +// * +// * Resources: http://www.html5rocks.com/en/tutorials/filters/understanding-css/ +// * +// * TODO: requires testing +// */ +// FIXME: .filter() requires the unlimited arguments feature. +.filter(...) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.grayscale(@amount) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.sepia(@amount) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.saturate(@amount) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.hue-rotation(@angle) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.invert(@amount) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +// .opacity() already taken, hence the -filter suffix. +.opacity-filter(@amount) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.brightness(@amount) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.contrast(@amount) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.blur(@radius) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.drop-shadow(@shadow) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} +.url(@url) { + -webkit-filter: @arguments; + -moz-filter: @arguments; + -ms-filter: @arguments; + -o-filter: @arguments; + filter: @arguments; +} + +///* +// * Border image +// * +// * Browsers support: Chrome, Firefox, Safari, Opera, Chrome for Android, Android Browser, Opera Mobile, Firefox for Android +// * Notable lack of support: IE, Opera Mini +// */ +.border-image(@url, @rest...) { + -webkit-border-image:url(@url) @rest; + -o-border-image:url(@url) @rest; + border-image:url(@url) @rest; +} + +///* +// * Flexible Box Model +// * +// * Resources: https://developer.mozilla.org/en-US/docs/CSS/Using_CSS_flexible_boxes +// * +// * Browsers Support: Chrome, Firefox 18*, Opera 12.1, Opera Mini 12.1 +// * Notable lack of support: IE, Firefox 17 (stable), Safari, Chrome for Android +// */ + +.display-flex() { + display: -webkit-flex; + display: -moz-flex; + display: flex; +} +.display-inline-flex(){ + display: -webkit-inline-flex; + display: -moz-inline-flex; + display: inline-flex; +} +.flex-direction(@direction) { + -webkit-flex-direction: @direction; + -moz-flex-direction: @direction; + flex-direction: @direction; +} +.justify-content(@alignment) { + -webkit-justify-content: @alignment; + -moz-justify-content: @alignment; + justify-content: @alignment; +} +.align-content(@alignment) { + -webkit-align-content: @alignment; + -moz-align-content: @alignment; + align-content: @alignment; +} +.align-items(@alignment) { + -webkit-align-items: @alignment; + -moz-align-items: @alignment; + align-items: @alignment; +} +.align-self(@alignment) { + -webkit-align-self: @alignment; + -moz-align-self: @alignment; + align-self: @alignment; +} +.flex(@arguments){ + -webkit-flex: @arguments; + -moz-flex: @arguments; + flex: @arguments; +} +.flex-basis(@basis) { + -webkit-flex-basis: @basis; + -moz-fles-basis: @basis; + flex-basis: @basis; +} +.flex-grow(@grow) { + -webkit-flex-grow: @grow; + -moz-flex-grow: @grow; + flex-grow: @grow; +} +.flex-shrink(@shrink) { + -webkit-flex-shrink: @shrink; + -moz-flex-shrink: @shrink; + flex-shrink: @shrink; +} +.flex-flow(@arguments) { + -webkit-flex-flow: @arguments; + -moz-flex-flow: @arguments; + flex-flow: @arguments; +} +.flex-direction(@direction) { + -webkit-flex-direction: @direction; + -moz-flex-direction: @direction; + flex-direction: @direction; +} +.flex-wrap(@wrap) { + -webkit-flex-wrap: @wrap; + -moz-flex-wrap: @wrap; + flex-wrap: @wrap; +} +.order(@order) { + -webkit-order: @order; + -moz-order: @order; + order: @order; +} + +///* +// * Appearance +// */ + +.appearance (@appearance) { + -webkit-appearance: @appearance; + -moz-appearance: @appearance; +} + +///* +// * Selection +// * +// * You can use it on the root of your CSS or inside a specyfic element. +// * +// * Examples: +// * 1. .selection(red, blue); +// * 2. p{ +// * .selection(red, blue) +// * } +// */ + +.selection(@text-color, @background-color) { + &::-moz-selection {color: @text-color; background-color: @background-color;} + &::selection {color: @text-color; background-color: @background-color;} +} + +///* +// * hasLayout +// * +// * http://reference.sitepoint.com/css/haslayout +// */ + +.hasLayout() {*zoom: 1;} + +///* +// * Normalize +// */ + +.normalize(){article,aside,details,figcaption,figure,footer,header,hgroup,nav,section,summary{display:block}audio,canvas,video{display:inline-block}audio:not([controls]){display:none;height:0}[hidden]{display:none}html{font-family:sans-serif;-webkit-text-size-adjust:100%;-ms-text-size-adjust:100%}body{margin:0}a:focus{outline:thin dotted}a:active,a:hover{outline:0}h1{font-size:2em}abbr[title]{border-bottom:1px dotted}b,strong{font-weight:bold}dfn{font-style:italic}mark{background:#ff0;color:#000}code,kbd,pre,samp{font-family:monospace,serif;font-size:1em}pre{white-space:pre;white-space:pre-wrap;word-wrap:break-word}q{quotes:"\201C" "\201D" "\2018" "\2019"}small{font-size:80%}sub,sup{font-size:75%;line-height:0;position:relative;vertical-align:baseline}sup{top:-0.5em}sub{bottom:-0.25em}img{border:0}svg:not(:root){overflow:hidden}figure{margin:0}fieldset{border:1px solid #c0c0c0;margin:0 2px;padding:.35em .625em .75em}legend{border:0;padding:0}button,input,select,textarea{font-family:inherit;font-size:100%;margin:0}button,input{line-height:normal}button,html input[type="button"],input[type="reset"],input[type="submit"]{-webkit-appearance:button;cursor:pointer}button[disabled],input[disabled]{cursor:default}input[type="checkbox"],input[type="radio"]{box-sizing:border-box;padding:0}input[type="search"]{-webkit-appearance:textfield;-moz-box-sizing:content-box;-webkit-box-sizing:content-box;box-sizing:content-box}input[type="search"]::-webkit-search-cancel-button,input[type="search"]::-webkit-search-decoration{-webkit-appearance:none}button::-moz-focus-inner,input::-moz-focus-inner{border:0;padding:0}textarea{overflow:auto;vertical-align:top}table{border-collapse:collapse;border-spacing:0}} + +///* +// * Reset +// */ + +.reset() {html,body,div,span,applet,object,iframe,h1,h2,h3,h4,h5,h6,p,blockquote,pre,a,abbr,acronym,address,big,cite,code,del,dfn,em,img,ins,kbd,q,s,samp,small,strike,strong,sub,sup,tt,var,b,u,i,center,dl,dt,dd,ol,ul,li,fieldset,form,label,legend,table,caption,tbody,tfoot,thead,tr,th,td,article,aside,canvas,details,embed,figure,figcaption,footer,header,hgroup,menu,nav,output,ruby,section,summary,time,mark,audio,video{margin:0;padding:0;border:0;font-size:100%;font:inherit;vertical-align:baseline}article,aside,details,figcaption,figure,footer,header,hgroup,menu,nav,section{display:block}body{line-height:1}ol,ul{list-style:none}blockquote,q{quotes:none}blockquote:before,blockquote:after,q:before,q:after{content:'';content:none}table{border-collapse:collapse;border-spacing:0}} + +///* +// * HTML5 Boiler Plate's default stylesheets. +// */ +.h5bp() {html,button,input,select,textarea{color:#222}body{font-size:1em;line-height:1.4}::-moz-selection{background:#b3d4fc;text-shadow:none}::selection{background:#b3d4fc;text-shadow:none}hr{display:block;height:1px;border:0;border-top:1px solid #ccc;margin:1em 0;padding:0}img{vertical-align:middle}fieldset{border:0;margin:0;padding:0}textarea{resize:vertical}.chromeframe{margin:.2em 0;background:#ccc;color:#000;padding:.2em 0}} +.h5bp-print() {@media print{*{background:transparent !important;color:#000 !important;box-shadow:none !important;text-shadow:none !important;} a,a:visited{text-decoration:underline;} a[href]:after{content:" (" attr(href) ")";} abbr[title]:after{content:" (" attr(title) ")";} .ir a:after,a[href^="javascript:"]:after,a[href^="#"]:after{content:"";} pre,blockquote{border:1px solid #999;page-break-inside:avoid;} thead{display:table-header-group;} tr,img{page-break-inside:avoid;} img{max-width:100% !important;} @page {margin:0.5cm;}p,h2,h3{orphans:3;widows:3;} h2,h3{page-break-after:avoid;}}.przerwa{color:#ff0000;}} + + +.ninja() { + color: black; + visibility: hidden; +} + diff --git a/docs/_themes/jrnl/static/less/docs.less b/docs/_themes/jrnl/static/less/docs.less new file mode 100644 index 00000000..3eaa34b3 --- /dev/null +++ b/docs/_themes/jrnl/static/less/docs.less @@ -0,0 +1,287 @@ +body + { + font-family: "Open Sans", "Helvetica Neue", sans-serif; + font-weight: 300; + color: #333; + background: @white; + } +body:not(.landing) + { + padding:0px 20px; + padding-top: 40px; + h2 + { + margin-top: 40px; + } + } +input + { + background: transparent; + border: 1px solid #999; + .border-radius(3px); + padding: 2px 5px; + color: #666; + font-family: "Open Sans"; + font-weight: 300; + outline: none; + &:focus + { + background: white; + } + } +div.related + { + background: rgba(255,200,200,.2); + } + +* > a.headerlink + { + display: none; + } + +h1, h2, h3, h4, h5, h6 + { + font-weight: 300; + } + +a:link, a:visited + { + color: @orange; + text-decoration: none; + } +a:hover, a:active + { + text-decoration: underline; + color: lighten(@orange, 10); + } + +.literal + { + color: @purple; + font-size: 1em; + background: lighten(@purple-light, 45); + padding: 1px 2px; + .border-radius(2px); + .box-shadow(inset 0px 0px 0px 1px lighten(@purple-light, 30)); + } + +.note + { + .gradient(lighten(@purple-light, 10), lighten(@purple-light-shade, 10)); + .border-radius(5px); + .box-shadow(0px 2px 3px @purple-shade); + padding: 10px 20px 10px 70px; + position: relative; + color: white; + .admonition-title {display: none;} + a { color: lighten(@orange, 30);} + &:before + { + content: ""; + display: block; + .icon; + .icon.info; + position: absolute; + margin: auto; + top: 0; bottom: 0; left: 20px; + } + .literal, .highlight-note + { + color: white; + background: darken(@purple-light, 3); + padding: 1px 3px; + .border-radius(2px); + .box-shadow(inset 0px 0px 0px 1px lighten(@purple-light, 10)); + } + .highlight-note + { + padding: 1px 10px; + pre:before + { + content: "$ "; + color: @orange; + } + } + } + +.highlight + { + background:transparent !important; + } +.highlight-output + { + .pre-block; + background: desaturate(lighten(@terminal,10), 10); + } +.highlight-javascript + { + .pre-block; + background: desaturate(lighten(@terminal,10), 10); + } +.highlight-python + { + .terminal; + pre + { + margin: 0 0 10px 0; + &:before + { + content: "$ "; + color: @orange; + } + } + } + +*:hover > a.headerlink + { + display: inline; + color: lighten(@purple-light, 30); + margin-left: 10px; + text-decoration: none; + &:hover { color: @purple-light; } + } + +tt + { + color: @purple; + font-size: 1.2em; + } +ul li { + margin-bottom: 10px; +} + +div.document + { + max-width: 900px; + margin: 20px auto; + position: relative; + } +div.documentwrapper + { + margin-left: 240px; + padding: 0; + } +aside + { + position: absolute; + width: 220px; + top: 0px; + .logo + { + margin: 0 auto 20px auto; + display: block; + width: 90px; + height: 98px; + } + color: #999; + h2, h3, h3 a:link, h3 a:visited + { + color: #777; + } + + a:link, a:visited + { + color: #999; + } + a:hover, a:active + { + color: @orange; + } + input[type=submit] + { + display: none; + } + &>ul + { + margin: 0 4px; + padding: 0; + list-style: none; + &>li + { + margin-bottom: 10px; + font-size: 18px; + color: #777; + a:link, a:visited {color: #777;} + ul + { + margin: 10px 0 0 0; + padding-left: 20px; + font-size: 16px; + color: #999; + a:link, a:visited {color: #999;} + } + } + } + } + +div.footer + { + font-size: .8em; + text-align: center; + margin: 40px 0; + color: #999; + a:link, a:visited {color: #555;} + } + +@media screen and (max-width: 820px) + { + body:not(.landing){ + padding-top: 130px; + .highlight-output,.highlight-python, .highlight-javascript + { + width: auto; + max-width: 500px; + } + .highlight-python + { + pre { margin: -10px 0 10px 0;} + &:before + { + height: 24px !important; + line-height: 24px; + font-size: .7em; + } + &:after + { + background: none; + } + } + aside + { + position: static; + } + div.documentwrapper + { + margin: 0px; + } + h1, .section + { + margin: 0px !important; + } + aside + { + background-color: #f0f0f0; + width: 100%; + margin: 5px -20px; + padding: 5px 20px 10px 20px; + } + #logolink + { + position: absolute; + top: -120px; + left: 50%; + margin-left: -49px; + } + } + + } +@media (-webkit-min-device-pixel-ratio: 1.5), (min--moz-device-pixel-ratio: 1.5), (-o-min-device-pixel-ratio: 3/2), (min-resolution: 1.5dppx) + { + aside .logo, body#landing #upper #logo + { + width: 90px; + height: 98px; + content: url(../img/logo@2x.png); + } + + } diff --git a/docs/_themes/jrnl/static/less/jrnl.less b/docs/_themes/jrnl/static/less/jrnl.less new file mode 100644 index 00000000..ce597b49 --- /dev/null +++ b/docs/_themes/jrnl/static/less/jrnl.less @@ -0,0 +1,317 @@ +@import "retina"; +@import "3L"; + +@white: #f7f8f9; +@blue: #5e7dc5; +@blue-light: #7c95ca; +@terminal: #2f1e34; +@purple: #47375d; +@purple-shade: #413155; +@purple-light: #725794; +@purple-light-shade: #564371; +@orange: #deaa09; + +.normalize(); +@import "docs.less"; + +.icon, + { + .sprite("../img/icons.png", 32px, 5, 3, 8px); + &.secure {.sprite(0, 0)}; + &.future {.sprite(1, 0)}; + &.search {.sprite(2, 0)}; + &.nli {.sprite(3, 0)}; + &.share {.sprite(0, 1)}; + &.sync {.sprite(0, 1)}; + &.dayone {.sprite(1, 1)}; + &.github {.sprite(2, 1)}; + &.folders{.sprite(3, 1)}; + &.cal {.sprite(4, 1)}; + &.left {.sprite(0, 2)}; + &.right {.sprite(1, 2)}; + &.info {.sprite(2, 2)}; + } + +.pre-block + { + background: @terminal; + .border-radius(6px); + padding: 1px 20px; + margin: 40px auto; + width: 500px; + .box-shadow(0px 1px 8px darken(@white, 30)); + position: relative; + color: @white; + font-family: "Monaco", "Courier New"; + font-size: 12pt; + #args {color: #f6f7b9} + #output {color: #9278b5} + } + +.terminal + { + .pre-block; + @p: 20px; + padding: @p + 30px @p (@p - 10px) @p; + &:before + { + content: "Terminal"; + display: block; + width: 100%; + position: absolute; + left: 0; + .box-shadow(inset 0px 1px 0px #f4f4f4, inset 0px -1px 0px #888); + margin-top: -50px; + // margin: -@p -@p 0px -@p; + text-align: center; + height: 30px; + line-height: 30px; + color: #777; + text-shadow: 0px 1px 0px #ddd; + .border-radius(5px 5px 0px 0px); + .gradient(#eaeaea, #bababa); + } + &:after + { + content: ""; + width: 48px; + height: 30px; + position: absolute; + top: 0px; + left: 10px; + background: url(../img/terminal.png) no-repeat center center; + } + } + +body#landing + { + background-color: @purple; + font-family: "Open Sans", "Helvetica Neue", sans-serif; + font-weight: 300; + #twitter + { + display: block; + position: absolute; + top: 20px; + right: 20px; + border: 1px solid @purple; + padding: 5px 10px 5px 30px; + color: @purple; + .border-radius(3px); + .opacity(.7); + background: url(../img/twitter.png) 8px center no-repeat transparent; + &:hover, &:active + { + .opacity(1); + text-decoration: none; + } + } + #title, .row3, .row4, #prompt + { + width: 900px; + margin: 0px auto; + } + #upper + { + .clearfix; + background: @white; + .box-shadow(inset 0px -6px 6px -3px darken(@white, 10)); + #title + { + width: 650px; + margin: 150px auto 75px auto; + } + img + { + float: left; + margin-right: 30px; + } + h1 + { + color: @purple-light-shade; + font-weight: 300; + } + #prompt + { + width: 640px; + margin: 0 auto; + .clearfix; + } + .terminal + { + .border-radius(6px 6px 0px 0px); + float: left; + margin: 0px; + width: 500px; + min-height: 134px; + .border-box-sizing; + } + .pleft, .pright + { + text-align: center; + .border-box-sizing; + float: left; + padding-top: 50px; + width: 70px; + i {.opacity(60);} + i:hover {.opacity(1000); cursor: pointer;} + } + } + #nav + { + .gradient(@blue-light, @blue); + height: 60px; + .box-shadow(0px 6px 6px -3px @purple-shade); + text-align: center; + a#twitter-nav {display: none;} + a + { + color: @white; + text-shadow: 0px -1px 0px darken(@blue, 30); + text-decoration: none; + font-size: 14pt; + line-height: 60px; + margin: 0 40px; + &:hover + { + color: lighten(@orange, 20); + text-shadow: 0px -1px 0px darken(@orange, 15); + } + } + a.cta + { + .gradient(@purple-light, @purple-light-shade); + .box-shadow(0px 1px 0px @purple-shade); + .border-radius(5px); + padding: 6px 10px 5px 10px; + white-space: nowrap; + &:hover + { + .gradient(lighten(@orange, 10), darken(@orange, 5)); + .box-shadow(0px 1px 0px darken(@orange, 15)); + text-shadow: 0px -1px 0px darken(@orange, 15); + color: @white; + + } + } + } + #lower + { + color: @white; + padding-top: 40px; + a + { + color: @orange; + text-decoration: none; + &:hover + { + color: lighten(@orange, 20); + text-decoration: underline; + } + } + .row3, .row4 { + .clearfix; + margin-bottom: 20px; + .col + { + position: relative; + padding-left: 40px; + i + { + position: absolute; + left: 0; + top: 16px; + } + h3 {font-size: 12pt; margin-bottom: .5em;} + p {font-size: 10pt; margin: 0;} + float: left; + width: 25%; + padding-right: 2%; + .border-box-sizing; + &:last-child {padding-right: 0;} + } + } + .row3 .col { width: 33.3333%; } + .row4 .col { color: mix(@white, @purple, 80); i {.opacity(80);}} + } + } + +@media screen and (max-width: 680px) + { + body#landing + { + #nav + { + height: auto; + padding-bottom: 10px; + a, a#twitter-nav + { + display: block; + } + a.cta + { + margin: 10px; + padding: 1px; + } + } + #upper + { + #twitter { display: none;} + #title + { + margin: 30px 0 10px 0; + } + #logo + { + backgound: red; + display: block; + float: none; + margin: 0px auto; + } + #title br {display: none;} + .pleft, .pright {display: none;} + #prompt, #title + { + width: 100%; + .border-box-sizing; + padding: 0px 20px; + } + .terminal + { + width: 100%; + } + } + } + } + +@media screen and (max-width: 900px) + { + body#landing + { + #lower + { + padding: 40px 20px; + .row3, .row4 + { + margin: 0px; + width: auto; + } + .row3 .col, .row4 .col + { + float: none; + width: 100%; + text-align: center; + padding: 0px; + margin: 0 0 40px 0; + h3 {font-size: 1.5em;} + p {font-size: 1em;} + + i + { + position: static; + margin-bottom: -20px; + } + } + } + } + } diff --git a/docs/_themes/jrnl/static/less/retina.less b/docs/_themes/jrnl/static/less/retina.less new file mode 100644 index 00000000..3c006c45 --- /dev/null +++ b/docs/_themes/jrnl/static/less/retina.less @@ -0,0 +1,35 @@ +// A helper mixin for applying high-resolution background images (http://www.retinajs.com) + +@highdpi: ~"(-webkit-min-device-pixel-ratio: 1.5), (min--moz-device-pixel-ratio: 1.5), (-o-min-device-pixel-ratio: 3/2), (min-resolution: 1.5dppx)"; + +.at2x(@path, @w: auto, @h: auto) { + background-image: url(@path); + @at2x_path: ~`@{path}.replace(/\.\w+$/, function(match) { return "@2x" + match; })`; + background-size: @w @h; + + @media @highdpi { + background-image: url("@{at2x_path}"); + } +} + +// Sprite mixin, see https://coderwall.com/p/oztebw + +.sprite (@path, @size, @w, @h, @pad: 0) when (isstring(@path)) + { + background-image: url(@path); + width: @size; + height: @size; + display: inline-block; + @at2x_path: ~`@{path}.replace(/\.[\w\?=]+$/, function(match) { return "@2x" + match; })`; + font-size: @size + @pad; + background-size: (@size + @pad) * @w (@size + @pad) * @h; + @media @highdpi + { + background-image: url("@{at2x_path}"); + } + } + +.sprite(@x, @y) + { + background-position: -@x * 1em -@y * 1em; + } diff --git a/docs/_themes/jrnl/static/sprites.svg b/docs/_themes/jrnl/static/sprites.svg new file mode 100755 index 00000000..a8420b9b --- /dev/null +++ b/docs/_themes/jrnl/static/sprites.svg @@ -0,0 +1,96 @@ +<?xml version="1.0" encoding="UTF-8" standalone="no"?> +<!-- Generator: IcoMoon.io --> + +<svg + xmlns:dc="http://purl.org/dc/elements/1.1/" + xmlns:cc="http://creativecommons.org/ns#" + xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#" + xmlns:svg="http://www.w3.org/2000/svg" + xmlns="http://www.w3.org/2000/svg" + xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd" + xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape" + width="1008" + height="48" + viewBox="0 0 1008 48" + data-tags="bookmark" + style="margin-left: -8px; margin-top: -8px;" + fill="#333333" + id="svg2" + version="1.1" + inkscape:version="0.48.2 r9819" + sodipodi:docname="sprites.svg"> + <metadata + id="metadata30"> + <rdf:RDF> + <cc:Work + rdf:about=""> + <dc:format>image/svg+xml</dc:format> + <dc:type + rdf:resource="http://purl.org/dc/dcmitype/StillImage" /> + </cc:Work> + </rdf:RDF> + </metadata> + <defs + id="defs28" /> + <sodipodi:namedview + pagecolor="#ffffff" + bordercolor="#666666" + borderopacity="1" + objecttolerance="10" + gridtolerance="10" + guidetolerance="10" + inkscape:pageopacity="0" + inkscape:pageshadow="2" + inkscape:window-width="1562" + inkscape:window-height="1153" + id="namedview26" + showgrid="true" + inkscape:zoom="2.7460317" + inkscape:cx="651.02496" + inkscape:cy="38.446605" + inkscape:window-x="0" + inkscape:window-y="0" + inkscape:window-maximized="0" + inkscape:current-layer="svg2"> + <inkscape:grid + type="xygrid" + id="grid3007" /> + </sodipodi:namedview> + <path + d="M 141.818,22.909l-15.273-6.545l 6.105-4.361C 129.469,8.651, 124.985,6.545, 120,6.545 C 111.545,6.545, 104.5,12.556, 102.892,20.535L 98.819,18.849C 101.136,9.29, 109.728,2.182, 120,2.182c 6.452,0, 12.227,2.819, 16.224,7.27L 141.818,5.455L 141.818,22.909 z M 107.35,35.998C 110.529,39.349, 115.015,41.455, 120,41.455c 8.487,0, 15.552-6.057, 17.123-14.084l 4.069,1.741C 138.888,38.69, 130.287,45.818, 120,45.818 c-6.452,0-12.229-2.819-16.224-7.27L 98.182,42.545l0-17.455 l 15.273,6.545L 107.35,35.998z" + id="path6" /> + <path + d="M 224.71875 2.09375 L 224.71875 10.8125 C 224.71875 10.8125 201.34725 10.877 200.78125 36.125 C 201.12625 32.307 203.78675 17.375 224.71875 17.375 L 224.71875 23.90625 L 240 13 L 224.71875 2.09375 z M 198 7 C 194.676 7 192 9.676 192 13 L 192 40 C 192 43.324 194.676 46 198 46 L 229 46 C 232.324 46 235 43.324 235 40 L 235 23 L 232 25 L 232 40 C 232 41.662 230.662 43 229 43 L 198 43 C 196.338 43 195 41.662 195 40 L 195 13 C 195 11.338 196.338 10 198 10 L 210 10 L 217 7 L 198 7 z " + id="path8" /> + <path + d="M 318,0.007c-9.941,0-18,8.059-18,18c0,3.039, 0.76,5.899, 2.093,8.412l-12.516,12.513l 0.011,0.009 C 288.609,39.903, 288,41.235, 288,42.715c0,2.924, 2.37,5.293, 5.293,5.293c 1.478,0, 2.811-0.609, 3.772-1.588l-0.003-0.003l 12.511-12.51 c 2.514,1.337, 5.379,2.1, 8.425,2.1c 9.941,0, 18-8.059, 18-18C 336,8.067, 327.941,0.007, 318,0.007z M 295.192,44.545 c-0.483,0.501-1.152,0.815-1.899,0.815c-1.462,0-2.647-1.183-2.647-2.646c0-0.747, 0.315-1.414, 0.815-1.899l-0.013-0.012l 12.099-12.099 c 1.057,1.426, 2.317,2.686, 3.741,3.747L 295.192,44.545z M 318,33.009c-8.283,0-15-6.719-15-15c0-8.283, 6.717-15, 15-15 c 8.281,0, 15,6.717, 15,15C 333,26.291, 326.282,33.009, 318,33.009zM 318,7.508 C 318.412,7.508 318.75,7.844 318.75,8.258 C 318.75,8.671 318.412,9.008 318,9.008 C 313.029,9.008 309,13.038 309,18.008 C 309,18.422 308.664,18.758 308.25,18.758 C 307.836,18.758 307.5,18.422 307.5,18.008 C 307.5,12.208 312.2,7.508 318,7.508 Z" + id="path10" /> + <path + d="M 421.5,19.5L 421.5,13.5 c0-7.457-6.043-13.5-13.5-13.5c-7.457,0-13.5,6.043-13.5,13.5l0,6 c-2.486,0-4.5,2.014-4.5,4.5l0,4.5 l0,1.5 l0,3 l0,1.5 c0,7.457, 6.043,13.5, 13.5,13.5l 9,0 c 7.457,0, 13.5-6.043, 13.5-13.5l0-1.5 l0-3 l0-1.5 l0-4.5 C 426,21.513, 423.984,19.5, 421.5,19.5z M 397.5,13.5c0-5.799, 4.701-10.5, 10.5-10.5c 5.799,0, 10.5,4.701, 10.5,10.5l0,6 l-3,0 L 415.5,13.503 c0-4.143-3.357-7.5-7.5-7.5c-4.143,0-7.5,3.357-7.5,7.5L 400.5,19.5 L 397.5,19.5 L 397.5,13.5 z M 414,13.5l0,0.005 L 414,19.5 l-12,0 L 402,13.503 L 402,13.5 c0-3.314, 2.686-6, 6-6C 411.313,7.5, 414,10.187, 414,13.5z M 423,28.5 l0,1.5 l0,3 l0,1.5 c0,5.788-4.712,10.5-10.5,10.5l-9,0 c-5.788,0-10.5-4.712-10.5-10.5l0-1.5 l0-3 l0-1.5 l0-4.5 c0-0.828, 0.672-1.5, 1.5-1.5c 1.001,0, 1.999,0, 3,0l 21,0 c 0.999,0, 1.998,0, 3,0 c 0.827,0, 1.5,0.672, 1.5,1.5L 423,28.5 zM 408,28.5 C 409.656,28.5 411,29.843 411,31.5 C 411,32.413 410.508,34.152 410.001,35.523 C 409.591,36.63 409.173,37.497 408,37.497 C 406.922,37.497 406.409,36.621 406,35.508 C 405.5,34.14 405,32.41 405,31.5 C 405,29.843 406.344,28.5 408,28.5 Z" + id="path12" /> + <path + d="M 524.093,3.87C 521.625,1.405, 518.376,0, 515.174,0c-2.701,0-5.189,1.002-7.005,2.816l-7.3,7.356 c-0.022,0.021-0.048,0.035-0.071,0.057c-0.012,0.012-0.019,0.028-0.032,0.039l 0.003,0.003L 485.276,25.884 c-0.714,0.71-1.232,1.593-1.519,2.558l-3.524,12.762C 480.229,41.238, 480,42.24, 480,42.75C 480,45.648, 482.353,48, 485.256,48 c 0.578,0, 1.695-0.276, 1.736-0.282l 12.717-3.344c 0.966-0.286, 1.844-0.808, 2.558-1.524l 22.895-23.075 C 529.325,15.609, 528.855,8.625, 524.093,3.87z M 504.021,35.693c-0.123-1.353-0.506-2.68-1.079-3.94l 14.183-14.181 c 0.867,2.739, 0.422,5.604-1.479,7.506c-0.012,0.012-0.027,0.019-0.038,0.032l 0.021,0.019l-11.592,11.685 C 504.037,36.439, 504.055,36.073, 504.021,35.693z M 502.189,30.384c-0.559-0.919-1.196-1.808-1.983-2.594 c-0.916-0.916-1.968-1.635-3.066-2.238l 14.298-14.298c 1.122,0.498, 2.198,1.208, 3.147,2.157c 0.812,0.808, 1.438,1.715, 1.921,2.656 L 502.189,30.384z M 495.729,24.843c-1.389-0.559-2.844-0.879-4.302-0.898l 11.555-11.643c 1.768-1.725, 4.344-2.222, 6.88-1.593 L 495.729,24.843z M 486.25,44.809C 486.087,44.847, 485.579,44.976, 485.233,45C 484,44.985, 483,43.983, 483,42.75 c 0.018-0.252, 0.118-0.685, 0.153-0.843l 1.579-5.721c 1.715-0.046, 3.56,0.621, 5.010,2.075c 1.473,1.47, 2.166,3.351, 2.091,5.087 L 486.25,44.809z M 493.311,42.956c-0.036-2.013-0.855-4.107-2.508-5.757C 489.24,35.634, 487.194,34.731, 485.154,34.65l 1.494-5.411 c 0.108-0.36, 0.323-0.716, 0.587-1.026c 3.009-2.154, 7.636-1.518, 10.851,1.7c 3.401,3.399, 3.925,8.379, 1.306,11.352 c-0.174,0.091-0.35,0.178-0.538,0.234L 493.311,42.956z M 523.036,17.658l-2.526,2.546c0-0.339, 0.041-0.664, 0.009-1.011 c-0.264-2.902-1.617-5.709-3.815-7.904c-2.444-2.445-5.684-3.848-8.892-3.857l 2.484-2.505C 511.541,3.687, 513.276,3, 515.174,3 c 2.413,0, 4.893,1.092, 6.8,2.993c 1.79,1.787, 2.856,4.006, 3.009,6.252C 525.123,14.34, 524.431,16.261, 523.036,17.658z" + id="path14" /> + <path + d="M 600,10.5 C 600.414,10.5 600.75,10.836 600.75,11.25 C 600.75,11.664 600.412,12 600,12 C 592.009,12 585,16.206 585,21 C 585,21.414 584.664,21.75 584.25,21.75 C 583.836,21.75 583.5,21.414 583.5,21 C 583.5,15.309 591.056,10.5 600,10.5 ZM 600,3C 586.745,3, 576,11.059, 576,21c0,6.191, 4.168,11.649, 10.512,14.889 C 586.512,35.929, 586.5,35.956, 586.5,36c0,2.689-2.008,5.585-2.892,7.104c 0.002,0, 0.003,0, 0.003,0C 583.54,43.269, 583.5,43.45, 583.5,43.641 C 583.5,44.391, 584.107,45, 584.859,45C 585,45, 585.248,44.963, 585.241,44.979c 4.688-0.768, 9.104-5.075, 10.13-6.322C 596.87,38.877, 598.415,39, 600,39 c 13.253,0, 24-8.059, 24-18C 624,11.059, 613.254,3, 600,3z M 600,36c-1.376,0-2.787-0.105-4.194-0.31c-0.146-0.024-0.291-0.032-0.435-0.032 c-0.891,0-1.744,0.396-2.319,1.095c-0.642,0.782-2.469,2.526-4.627,3.809c 0.585-1.343, 1.042-2.847, 1.074-4.398 c 0.009-0.096, 0.013-0.194, 0.013-0.276c0-1.128-0.631-2.159-1.635-2.671C 582.318,30.378, 579,25.811, 579,21C 579,12.729, 588.42,6, 600,6 c 11.577,0, 21,6.729, 21,15C 621,29.271, 611.579,36, 600,36z" + id="path16" /> + <path + d="M 774 0 L 771 26.84375 L 773.96875 27.15625 L 776.65625 3 L 807.34375 3 L 810.03125 27.15625 L 813 26.84375 L 810 0 L 774 0 z M 780 6 L 780 9 L 804 9 L 804 6 L 780 6 z M 780 12 L 780 15 L 804 15 L 804 12 L 780 12 z M 780 18 L 780 21 L 804 21 L 804 18 L 780 18 z M 780 24 L 780 27 L 804 27 L 804 24 L 780 24 z M 769.5 30 C 768.675 30 768.20775 30.6545 768.46875 31.4375 L 773.53125 46.5625 C 773.79225 47.3455 774.675 48 775.5 48 L 808.5 48 C 809.325 48 810.20775 47.3455 810.46875 46.5625 L 815.53125 31.4375 C 815.79325 30.6545 815.325 30 814.5 30 L 769.5 30 z M 786 33 L 798 33 L 798 36 L 786 36 L 786 33 z " + id="path20" /> + <path + d="M 888 0 C 874.745 0 864 10.745 864 24 C 864 37.255 874.745 48 888 48 C 901.255 48 912 37.255 912 24 C 912 10.745 901.255 0 888 0 z M 888 3 C 899.59798 3 909 12.402018 909 24 C 909 33.513233 902.67471 41.543499 894 44.125 L 894 43.25 L 894 41.53125 L 894 39.65625 C 894 37.76525 893.32825 36.35975 892.03125 35.46875 C 892.84425 35.39075 893.60225 35.29625 894.28125 35.15625 C 894.96025 35.01625 895.6795 34.8275 896.4375 34.5625 C 897.1955 34.2975 897.86675 33.96075 898.46875 33.59375 C 899.07075 33.22675 899.66475 32.74225 900.21875 32.15625 C 900.77275 31.57025 901.21875 30.9295 901.59375 30.1875 C 901.96875 29.4455 902.281 28.539 902.5 27.5 C 902.719 26.461 902.8125 25.3125 902.8125 24.0625 C 902.8125 21.6405 902.04675 19.579 900.46875 17.875 C 901.18775 16 901.09375 13.953 900.21875 11.75 L 899.625 11.6875 C 899.219 11.6405 898.4915 11.82775 897.4375 12.21875 C 896.3835 12.60975 895.21925 13.234 893.90625 14.125 C 892.04725 13.609 890.09375 13.375 888.09375 13.375 C 886.07775 13.375 884.17175 13.61 882.34375 14.125 C 881.51575 13.562 880.742 13.118 880 12.75 C 879.258 12.383 878.66375 12.133 878.21875 12 C 877.77375 11.867 877.35175 11.781 876.96875 11.75 C 876.58575 11.719 876.32775 11.70275 876.21875 11.71875 C 876.10975 11.73475 876.046 11.76525 876 11.78125 C 875.125 14.00025 875.031 16.016 875.75 17.875 C 874.172 19.578 873.375 21.6405 873.375 24.0625 C 873.375 25.3125 873.49975 26.461 873.71875 27.5 C 873.93775 28.539 874.21875 29.4455 874.59375 30.1875 C 874.96875 30.9295 875.445 31.57025 876 32.15625 C 876.555 32.74225 877.149 33.22575 877.75 33.59375 C 878.351 33.96175 879.02325 34.2975 879.78125 34.5625 C 880.53925 34.8275 881.0085 35.01625 881.6875 35.15625 C 882.3665 35.29625 883.1255 35.422 883.9375 35.5 C 882.6565 36.375 882 37.75025 882 39.65625 L 882 41.34375 L 882 43.3125 L 882 44.125 C 873.3253 41.543499 867 33.513233 867 24 C 867 12.402018 876.40203 3 888 3 z " + id="path22" /> + <path + d="M 978.072,25.441c-0.267,0.386-0.593,1.352-0.978,1.588c-0.386,0.235-0.821,0.401-1.304,0.492 c-0.485,0.093-0.986,0.134-1.503,0.118l0,2.29 l 3.7,0 L 977.988,39 l 2.987,0 l0-14.994 l-2.376,0 C 978.514,24.578, 978.339,25.056, 978.072,25.441z M 994.5,12l 3,0 c 0.83,0, 1.5-0.672, 1.5-1.5L 999,1.5 c0-0.828-0.67-1.5-1.5-1.5l-3,0 c-0.83,0-1.5,0.672-1.5,1.5l0,9 C 993,11.328, 993.67,12, 994.5,12z M 970.5,12l 3,0 c 0.828,0, 1.5-0.672, 1.5-1.5L 975,1.5 c0-0.828-0.672-1.5-1.5-1.5L 970.5,0 C 969.672,0, 969,0.672, 969,1.5l0,9 C 969,11.328, 969.672,12, 970.5,12z M 1005,6l-3,0 l0,7.5 c0,0.828-0.67,1.5-1.5,1.5l-9,0 c-0.83,0-1.5-0.672-1.5-1.5L 990,6 l-12,0 l0,7.5 c0,0.828-0.672,1.5-1.5,1.5L 967.5,15 c-0.828,0-1.5-0.672-1.5-1.5L 966,6 L 963,6 C 961.344,6, 960,7.344, 960,9l0,36 c0,1.656, 1.344,3, 3,3l 42,0 c 1.656,0, 3-1.344, 3-3L 1008,9 C 1008,7.344, 1006.656,6, 1005,6z M 1005,43.5c0,0.83-0.67,1.5-1.5,1.5L 964.5,45 c-0.828,0-1.5-0.67-1.5-1.5L 963,19.5 c0-0.828, 0.672-1.5, 1.5-1.5l 39,0 c 0.83,0, 1.5,0.672, 1.5,1.5L 1005,43.5 z M 983.977,26.973l 7.452,0 c-1.404,1.728-2.534,3.488-3.397,5.558c-0.862,2.071-0.957,4.227-1.123,6.468l 3.196,0 c 0.013-0.999-0.292-2.078-0.076-3.234c 0.219-1.157, 0.528-2.298, 0.925-3.428c 0.401-1.128, 0.897-2.192, 1.494-3.19 c 0.594-1.001, 1.28-1.844, 2.050-2.529l0-2.613 l-10.522,0 L 983.976,26.973 z" + id="path24" /> + <path + style="fill:#333333;fill-opacity:1;stroke:none" + d="M 9.46875,0 C 6.437316,0 4,2.4373158 4,5.46875 l 0,37.0625 C 4,45.562684 6.437316,48 9.46875,48 l 29.0625,0 C 41.562684,48 44,45.562684 44,42.53125 L 44,5.46875 C 44,2.4373158 41.562684,0 38.53125,0 z M 11,3 l 2,0 0,42 -2,0 C 8.784,45 7,43.216 7,41 L 7,7 C 7,4.784 8.784,3 11,3 z m 5,0 11,0 0,13 4,-3 4,3 0,-13 2,0 c 2.216,0 4,1.784 4,4 l 0,34 c 0,2.216 -1.784,4 -4,4 l -21,0 z" + id="rect3009" + inkscape:connector-curvature="0" + sodipodi:nodetypes="ssssssssssccssssccccccsssscc" /> + <path + style="font-size:medium;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-indent:0;text-align:start;text-decoration:none;line-height:normal;letter-spacing:normal;word-spacing:normal;text-transform:none;direction:ltr;block-progression:tb;writing-mode:lr-tb;text-anchor:start;baseline-shift:baseline;color:#000000;fill:#333333;fill-opacity:1;stroke:none;stroke-width:3;marker:none;visibility:visible;display:inline;overflow:visible;enable-background:accumulate;font-family:Sans;-inkscape-font-specification:Sans" + d="M 697 -1 C 696.25371 -1 695.55642 -0.73689699 695 -0.28125 C 694.44358 0.17439699 694 0.87583597 694 1.71875 L 694 3 L 693 3 L 693 4 L 687.5 4 C 687.448 3.99729 687.39579 3.99729 687.34375 4 C 686.61183 4.0767148 685.99606 4.7640806 686 5.5 L 686 6 L 684.5 6 C 683.71462 6.0000785 683.00008 6.7146233 683 7.5 L 683 8.09375 C 682.42224 8.2980557 682.0033 8.8871877 682 9.5 L 682 12.5 C 682.00008 13.285377 682.71462 13.999921 683.5 14 L 686 14 L 686 39 L 684.75 40.1875 C 684.29266 40.451552 683.9953 40.971929 684 41.5 L 684 44.5 C 684.00008 45.285377 684.71462 45.999921 685.5 46 L 693.40625 46 L 700.5 46 L 700.65625 46 L 708.5 46 C 709.28538 45.999921 709.99992 45.285377 710 44.5 L 710 41.5 C 710.005 40.971929 709.70734 40.451552 709.25 40.1875 L 708 39 L 708 14 L 710.5 14 C 711.28538 13.999921 711.99992 13.285377 712 12.5 L 712 9.5 C 711.997 8.8871877 711.57776 8.2980557 711 8.09375 L 711 7.5 C 710.99992 6.7146233 710.28538 6.0000785 709.5 6 L 708 6 L 708 5.5 C 707.99992 4.7146233 707.28538 4.0000785 706.5 4 L 701 4 L 701 3 L 700 3 L 700 1.71875 C 700 0.87583597 699.55642 0.17439702 699 -0.28125 C 698.44358 -0.73689702 697.74629 -1 697 -1 z M 697 1 C 697.20585 1 697.5132 1.1129297 697.71875 1.28125 C 697.9243 1.4495703 698 1.6095221 698 1.71875 L 698 3 L 696 3 L 696 1.71875 C 696 1.6095221 696.0757 1.4495702 696.28125 1.28125 C 696.4868 1.1129298 696.79415 1 697 1 z M 688 7 L 706 7 L 706 8 L 708 8 C 707.9472 8.7370898 708.11489 9.2632977 709 9.0625 L 709 12 L 705 12 L 689 12 L 685 12 L 685 9.15625 C 685.81891 9.2047089 685.94068 8.6267293 686 8 L 688 8 L 688 7 z M 689 14 L 705 14 L 705 41 L 707 42.375 L 707 43 L 687 43 L 687 42.375 L 689 41 L 689 14 z M 691 16 L 691 20 L 693 20 L 693 16 L 691 16 z M 694 16 L 694 20 L 696 20 L 696 16 L 694 16 z M 698 16 L 698 20 L 700 20 L 700 16 L 698 16 z M 701 16 L 701 20 L 703 20 L 703 16 L 701 16 z M 691 21 L 691 25 L 693 25 L 693 21 L 691 21 z M 694 21 L 694 25 L 696 25 L 696 21 L 694 21 z M 698 21 L 698 25 L 700 25 L 700 21 L 698 21 z M 701 21 L 701 25 L 703 25 L 703 21 L 701 21 z M 699.375 29.625 C 698.61451 29.625 698 30.239511 698 31 C 698 31.760489 698.61451 32.375 699.375 32.375 C 700.13549 32.375 700.75 31.760489 700.75 31 C 700.75 30.239511 700.13549 29.625 699.375 29.625 z " + id="path3858" /> +</svg> diff --git a/docs/_themes/jrnl/theme.conf b/docs/_themes/jrnl/theme.conf new file mode 100755 index 00000000..fc3d3735 --- /dev/null +++ b/docs/_themes/jrnl/theme.conf @@ -0,0 +1,7 @@ +[theme] +inherit = basic +stylesheet = css/jrnl.css +pygments_style = flask_theme_support.FlaskyStyle + +[options] +touch_icon = diff --git a/docs/advanced.rst b/docs/advanced.rst new file mode 100644 index 00000000..10c204b7 --- /dev/null +++ b/docs/advanced.rst @@ -0,0 +1,100 @@ +.. _advanced: + +Advanced Usage +============== + +Configuration File +------------------- + +The configuration file is a simple JSON file with the following options. + +- ``journals`` + paths to your journal files +- ``editor`` + if set, executes this command to launch an external editor for writing your entries, e.g. ``vim`` or ``subl -w`` (note the ``-w`` flag to make sure _jrnl_ waits for Sublime Text to close the file before writing into the journal. If you're using MacVim, that would be ``mvim -f``). +- ``encrypt`` + if ``true``, encrypts your journal using AES. +- ``tagsymbols`` + Symbols to be interpreted as tags. (__See note below__) +- ``default_hour`` and ``default_minute`` + if you supply a date, such as ``last thursday``, but no specific time, the entry will be created at this time +- ``timeformat`` + how to format the timestamps in your journal, see the [python docs](http://docs.python.org/library/time.html#time.strftime) for reference +- ``highlight`` + if ``true``, tags will be highlighted in cyan. +- ``linewrap`` + controls the width of the output. Set to ``false`` if you don't want to wrap long lines. + +.. note:: + + Although it seems intuitive to use the `#` character for tags, there's a drawback: on most shells, this is interpreted as a meta-character starting a comment. This means that if you type + + .. code-block:: note + + jrnl Implemented endless scrolling on the #frontend of our website. + + your bash will chop off everything after the ``#`` before passing it to _jrnl_). To avoid this, wrap your input into quotation marks like this: + + .. code-block:: note + + jrnl "Implemented endless scrolling on the #frontend of our website." + + Or use the built-in prompt or an external editor to compose your entries. + +DayOne Integration +------------------ + +Using your DayOne journal instead of a flat text file is dead simple - instead of pointing to a text file, change your `.jrnl_conf` to point to your DayOne journal. This is a folder ending with `.dayone`, and it's located at + +* ``~/Library/Application Support/Day One/`` by default +* ``~/Dropbox/Apps/Day One/`` if you're syncing with Dropbox and +* ``~/Library/Mobile Documents/5U8NS4GX82~com~dayoneapp~dayone/Documents/`` if you're syncing with iCloud. + +Instead of all entries being in a single file, each entry will live in a separate `plist` file. You can also star entries when you write them: + + jrnl -star yesterday: Lunch with @Arthur + +Multiple journal files +---------------------- + +You can configure _jrnl_ to use with multiple journals (eg. ``private`` and ``work``) by defining more journals in your ``.jrnl_config``, for example: + +.. code-block:: javascript + + { + ... + "journals": { + "default": "~/journal.txt", + "work": "~/work.txt" + } + } + +The ``default`` journal gets created the first time you start _jrnl_. Now you can access the ``work`` journal by using ``jrnl work`` instead of ``jrnl``, eg. :: + + jrnl work at 10am: Meeting with @Steve + jrnl work -n 3 + +will both use ``~/work.txt``, while ``jrnl -n 3`` will display the last three entries from ``~/journal.txt`` (and so does ``jrnl default -n 3``). + +You can also override the default options for each individual journal. If you ``.jrnl_conf`` looks like this: + +.. code-block:: javascript + + { + ... + "encrypt": false + "journals": { + "default": "~/journal.txt", + "work": { + "journal": "~/work.txt", + "encrypt": true + }, + "food": "~/my_recipes.txt", + } + +Your ``default`` and your ``food`` journals won't be encrypted, however your ``work`` journal will! You can override all options that are present at the top level of ``.jrnl_conf``, just make sure that at the very least you specify a ``"journal": ...`` key that points to the journal file of that journal. + +.. note:: + + Changing ``encrypt`` to a different value will not encrypt or decrypt your journal file, it merely says whether or not your journal `is` encrypted. Hence manually changing this option will most likely result in your journal file being impossible to load. + diff --git a/docs/conf.py b/docs/conf.py new file mode 100644 index 00000000..5ac4da07 --- /dev/null +++ b/docs/conf.py @@ -0,0 +1,254 @@ +# -*- coding: utf-8 -*- +# +# jrnl documentation build configuration file, created by +# sphinx-quickstart on Wed Aug 7 13:22:51 2013. +# +# This file is execfile()d with the current directory set to its containing dir. +# +# Note that not all possible configuration values are present in this +# autogenerated file. +# +# All configuration values have a default; values that are commented out +# serve to show the default. + +import sys, os +sys.path.insert(0, os.path.abspath('..')) +import jrnl +from jrnl import __version__ + +# If extensions (or modules to document with autodoc) are in another directory, +# add these directories to sys.path here. If the directory is relative to the +# documentation root, use os.path.abspath to make it absolute, like shown here. +#sys.path.insert(0, os.path.abspath('.')) + +# -- General configuration ----------------------------------------------------- + +# If your documentation needs a minimal Sphinx version, state it here. +#needs_sphinx = '1.0' + +# Add any Sphinx extension module names here, as strings. They can be extensions +# coming with Sphinx (named 'sphinx.ext.*') or your custom ones. +extensions = ['sphinx.ext.autodoc'] + +# Add any paths that contain templates here, relative to this directory. +templates_path = ['_templates'] + +# The suffix of source filenames. +source_suffix = '.rst' + +# The encoding of source files. +#source_encoding = 'utf-8-sig' + +# The master toctree document. +master_doc = 'index' + +# General information about the project. +project = u'jrnl' +copyright = u'Journal is made with love by <a href="http://www.1450.me">Manuel Ebert</a> and <a href="https://github.com/maebert/jrnl/graphs/contributors" title="Contributtors">other fabulous people</a>. If you need help, tweet to <a href="https://twitter.com/maebert" title="Follow @maebert on twitter">@maebert</a> or <a href="https://github.com/maebert/jrnl/issues/new" title="Open a new issue on Github">submit an issue</a> on Github.' + +# The version info for the project you're documenting, acts as replacement for +# |version| and |release|, also used in various other places throughout the +# built documents. +# +# The short X.Y version. +version = __version__ +# The full version, including alpha/beta/rc tags. +release = version + +# The language for content autogenerated by Sphinx. Refer to documentation +# for a list of supported languages. +#language = None + +# There are two options for replacing |today|: either, you set today to some +# non-false value, then it is used: +#today = '' +# Else, today_fmt is used as the format for a strftime call. +#today_fmt = '%B %d, %Y' + +# List of patterns, relative to source directory, that match files and +# directories to ignore when looking for source files. +exclude_patterns = ['_build'] + +# The reST default role (used for this markup: `text`) to use for all documents. +#default_role = None + +# If true, '()' will be appended to :func: etc. cross-reference text. +#add_function_parentheses = True + +# If true, the current module name will be prepended to all description +# unit titles (such as .. function::). +#add_module_names = True + +# If true, sectionauthor and moduleauthor directives will be shown in the +# output. They are ignored by default. +#show_authors = False + +# The name of the Pygments (syntax highlighting) style to use. +pygments_style = 'native' + +# A list of ignored prefixes for module index sorting. +#modindex_common_prefix = [] + +# If true, keep warnings as "system message" paragraphs in the built documents. +#keep_warnings = False + + +# -- Options for HTML output --------------------------------------------------- + +# The theme to use for HTML and HTML Help pages. See the documentation for +# a list of builtin themes. +html_theme = 'jrnl' + +# Theme options are theme-specific and customize the look and feel of a theme +# further. For a list of options available for each theme, see the +# documentation. +#html_theme_options = {} + +# Add any paths that contain custom themes here, relative to this directory. +#html_theme_path = [] + +# The name for this set of Sphinx documents. If None, it defaults to +# "<project> v<release> documentation". +#html_title = None + +# A shorter title for the navigation bar. Default is the same as html_title. +#html_short_title = None + +# The name of an image file (relative to this directory) to place at the top +# of the sidebar. +#html_logo = None + +# The name of an image file (within the static path) to use as favicon of the +# docs. This file should be a Windows icon file (.ico) being 16x16 or 32x32 +# pixels large. +#html_favicon = None + +# Add any paths that contain custom static files (such as style sheets) here, +# relative to this directory. They are copied after the builtin static files, +# so a file named "default.css" will overwrite the builtin "default.css". +html_static_path = ['_static'] + +# If not '', a 'Last updated on:' timestamp is inserted at every page bottom, +# using the given strftime format. +#html_last_updated_fmt = '%b %d, %Y' + +# If true, SmartyPants will be used to convert quotes and dashes to +# typographically correct entities. +#html_use_smartypants = True + +# Custom sidebar templates, maps document names to template names. +#html_sidebars = {} + +# Additional templates that should be rendered to pages, maps page names to +# template names. +#html_additional_pages = {} + +# If false, no module index is generated. +#html_domain_indices = True + +# If false, no index is generated. +#html_use_index = True + +# If true, the index is split into individual pages for each letter. +#html_split_index = False + +# If true, links to the reST sources are added to the pages. +html_show_sourcelink = False + +# If true, "Created using Sphinx" is shown in the HTML footer. Default is True. +html_show_sphinx = False + +# If true, "(C) Copyright ..." is shown in the HTML footer. Default is True. +#html_show_copyright = True + +# If true, an OpenSearch description file will be output, and all pages will +# contain a <link> tag referring to it. The value of this option must be the +# base URL from which the finished HTML is served. +#html_use_opensearch = '' + +# This is the file name suffix for HTML files (e.g. ".xhtml"). +#html_file_suffix = None + +# Output file base name for HTML help builder. +htmlhelp_basename = 'jrnldoc' + + +# -- Options for LaTeX output -------------------------------------------------- + +latex_elements = { +# The paper size ('letterpaper' or 'a4paper'). +#'papersize': 'letterpaper', + +# The font size ('10pt', '11pt' or '12pt'). +#'pointsize': '10pt', + +# Additional stuff for the LaTeX preamble. +#'preamble': '', +} + +# Grouping the document tree into LaTeX files. List of tuples +# (source start file, target name, title, author, documentclass [howto/manual]). +latex_documents = [ + ('index', 'jrnl.tex', u'jrnl Documentation', + u'Manuel Ebert', 'manual'), +] + +# The name of an image file (relative to this directory) to place at the top of +# the title page. +#latex_logo = None + +# For "manual" documents, if this is true, then toplevel headings are parts, +# not chapters. +#latex_use_parts = False + +# If true, show page references after internal links. +#latex_show_pagerefs = False + +# If true, show URL addresses after external links. +#latex_show_urls = False + +# Documents to append as an appendix to all manuals. +#latex_appendices = [] + +# If false, no module index is generated. +#latex_domain_indices = True + + +# -- Options for manual page output -------------------------------------------- + +# One entry per manual page. List of tuples +# (source start file, name, description, authors, manual section). +man_pages = [ + ('index', 'jrnl', u'jrnl Documentation', + [u'Manuel Ebert'], 1) +] + +# If true, show URL addresses after external links. +#man_show_urls = False + + +# -- Options for Texinfo output ------------------------------------------------ + +# Grouping the document tree into Texinfo files. List of tuples +# (source start file, target name, title, author, +# dir menu entry, description, category) +texinfo_documents = [ + ('index', 'jrnl', u'jrnl Documentation', + u'Manuel Ebert', 'jrnl', 'One line description of project.', + 'Miscellaneous'), +] + +# Documents to append as an appendix to all manuals. +#texinfo_appendices = [] + +# If false, no module index is generated. +#texinfo_domain_indices = True + +# How to display URL addresses: 'footnote', 'no', or 'inline'. +#texinfo_show_urls = 'footnote' + +# If true, do not generate a @detailmenu in the "Top" node's menu. +#texinfo_no_detailmenu = False +sys.path.append(os.path.abspath('_themes')) +html_theme_path = ['_themes'] +html_theme = 'jrnl' diff --git a/docs/encryption.rst b/docs/encryption.rst new file mode 100644 index 00000000..ebb54865 --- /dev/null +++ b/docs/encryption.rst @@ -0,0 +1,39 @@ +.. _encryption: + +Encryption +========== + +Encrypting and decrypting +------------------------- + + +If you don't choose to encrypt your file when you run `jrnl` for the first time, you can encrypt your existing journal file or change its password using :: + + jrnl --encrypt + +If it is already encrypted, you will first be asked for the current password. You can then enter a new password and your plain journal will replaced by the encrypted file. Conversely, :: + + jrnl --decrypt + +will replace your encrypted journal file by a Journal in plain text. You can also specify a filename, ie. `jrnl --decrypt plain_text_copy.txt`, to leave your original file untouched. + + +Storing passwords in your keychain +---------------------------------- + +Whenever you encrypt your journal, you are asked whether you want to store the encryption password in your keychain. If you do this, you won't have to enter your password every time you want to write or read your journal. + +If you don't initially store the password in the keychain but decide to do so at a later point -- or maybe want to store it on one computer but not on another -- you can simply run `jrnl --encrypt` on an encrypted journal and use the same password again. + + +Manual decryption +----------------- + +Should you ever want to decrypt your journal manually, you can do so with any program that supports the AES algorithm. The key used for encryption is the SHA-256-hash of your password, and the IV (initialisation vector) is stored in the first 16 bytes of the encrypted file. So, to decrypt a journal file in python, run:: + + import hashlib, Crypto.Cipher + key = hashlib.sha256(my_password).digest() + with open("my_journal.txt") as f: + cipher = f.read() + crypto = AES.new(key, AES.MODE_CBC, iv = cipher[:16]) + plain = crypto.decrypt(cipher[16:]) diff --git a/docs/export.rst b/docs/export.rst new file mode 100644 index 00000000..4a040b09 --- /dev/null +++ b/docs/export.rst @@ -0,0 +1,67 @@ +.. _export: + +Import and Export +================= + +Tag export +---------- + +With:: + + jrnl --tags + +you'll get a list of all tags you used in your journal, sorted by most frequent. Tags occurring several times in the same entry are only counted as one. + +List of all entries +------------------- + + jrnl --short + +Will only display the date and title of each entry. + +JSON export +----------- + +Can do:: + + jrnl --export json + +Why not create a `beautiful timeline <http://timeline.verite.co/>`_ of your journal? + +Markdown export +--------------- + +Use:: + + jrnl --export markdown + +Markdown is a simple markup language that is human readable and can be used to be rendered to other formats (html, pdf). This README for example is formatted in markdown and github makes it look nice. + +Text export +----------- + +:: + + jrnl --export text + +Pretty-prints your entire journal. + +Export to files +--------------- + +You can specify the output file of your exported journal using the `-o` argument:: + + jrnl --export md -o journal.md + +The above command will generate a file named `journal.md`. If the `-o` argument is a directory, jrnl will export each entry into an individual file:: + + jrnl --export json -o my_entries/ + +The contents of `my_entries/` will then look like this: + +.. code-block:: output + + my_entries/ + |- 2013_06_03_a-beautiful-day.json + |- 2013_06_07_dinner-with-gabriel.json + |- ... diff --git a/docs/index.rst b/docs/index.rst new file mode 100644 index 00000000..c7d7119b --- /dev/null +++ b/docs/index.rst @@ -0,0 +1,20 @@ +.. jrnl documentation master file, created by + sphinx-quickstart on Wed Aug 7 13:22:51 2013. + +jrnl: The command-line journal +============================== + +Release v\ |version|. + +Contents: + +.. toctree:: + :maxdepth: 3 + + overview + installation + usage + encryption + export + advanced + recipes diff --git a/docs/installation.rst b/docs/installation.rst new file mode 100644 index 00000000..709eb9c3 --- /dev/null +++ b/docs/installation.rst @@ -0,0 +1,41 @@ +.. _download: + +Getting started +=============== + +Installation +------------ + +Install *jrnl* using pip :: + + pip install jrnl + +Or, if you want the option to encrypt your journal, :: + + pip install jrnl[encrypted] + +to install the dependencies for encrypting journals as well. + +.. note:: + + Installing the encryption library, `pycrypto`, requires a `gcc` compiler. For this reason, jrnl will not install `pycrypto` unless explicitly told so like this. You can `install PyCyrypto manually <https://www.dlitz.net/software/pycrypto/>`_ first or install it with ``pip install pycrypto`` if you have a `gcc` compiler. + +The first time you run ``jrnl`` you will be asked where your journal file should be created and whether you wish to encrypt it. + + +Quickstart +---------- + +to make a new entry, just type:: + + jrnl yesterday: Called in sick. Used the time to clean the house and spent 4h on writing my book. + +and hit return. ``yesterday:`` will be interpreted as a time stamp. Everything until the first sentence mark (``.?!:``) will be interpreted as the title, the rest as the body. In your journal file, the result will look like this: + +.. code-block:: output + + 2012-03-29 09:00 Called in sick. + Used the time to clean the house and spent 4h on writing my book. + +If you just call ``jrnl``, you will be prompted to compose your entry - but you can also configure *jrnl* to use your external editor. + diff --git a/docs/overview.rst b/docs/overview.rst new file mode 100644 index 00000000..532fde36 --- /dev/null +++ b/docs/overview.rst @@ -0,0 +1,19 @@ +.. _overview: + +Overview +=============== + +What is jrnl? +------------- + +`jrnl` is a simple journal application for your command line. Journals are stored as human readable plain text files - you can put them into a Dropbox folder for instant syncing and you can be assured that your journal will still be readable in 2050, when all your fancy iPad journal applications will long be forgotten. + +`jrnl` also plays nice with the fabulous `DayOne <http://dayoneapp.com>`_ and can read and write directly from and to DayOne Journals. + +Optionally, your journal can be encrypted using the `256-bit AES <http://en.wikipedia.org/wiki/Advanced_Encryption_Standard>`_. + +Why keep a journal? +------------------- + +Journals aren't only for 13-year old girls and people who have too much time on their summer vacation. A journal helps you to keep track of the things you get done and how you did them. Your imagination may be limitless, but your memory isn't. For personal use, make it a good habit to write at least 20 words a day. Just to reflect what made this day special, why you haven't wasted it. For professional use, consider a text-based journal to be the perfect complement to your GTD todo list - a documentation of what and how you've done it. + diff --git a/docs/recipes.rst b/docs/recipes.rst new file mode 100644 index 00000000..9ae55a86 --- /dev/null +++ b/docs/recipes.rst @@ -0,0 +1,31 @@ +.. _recipes: + +FAQ +=== + +Recipes +------- + +Co-occurrence of tags +~~~~~~~~~~~~~~~~~~~~~ + +If I want to find out how often I mentioned my flatmates Alberto and Melo in the same entry, I run :: + + jrnl @alberto --tags | grep @melo + +And will get something like ``@melo: 9``, meaning there are 9 entries where both ``@alberto`` and ``@melo`` are tagged. How does this work? First, ``jrnl @alberto`` will filter the journal to only entries containing the tag ``@alberto``, and then the ``--tags`` option will print out how often each tag occurred in this `filtered` journal. Finally, we pipe this to ``grep`` which will only display the line containing ``@melo``. + +Combining filters +~~~~~~~~~~~~~~~~~ + +You can do things like :: + + jrnl @fixed -starred -n 10 -until "jan 2013" --short + +To get a short summary of the 10 most recent, favourited entries before January 1, 2013 that are tagged with ``@fixed``. + +Known Issues +------------ + +- The Windows shell prior to Windows 7 has issues with unicode encoding. If you want to use non-ascii characters, change the codepage with ``chcp 1252`` before using `jrnl` (Thanks to Yves Pouplard for solving this!) +- _jrnl_ relies on the `PyCrypto` package to encrypt journals, which has some known problems with installing on Windows and within virtual environments. diff --git a/docs/usage.rst b/docs/usage.rst new file mode 100644 index 00000000..c17bd761 --- /dev/null +++ b/docs/usage.rst @@ -0,0 +1,84 @@ +.. _usage: + +Basic Usage +=========== + +*jrnl* has two modes: **composing** and **viewing**. Basically, whenever you `don't` supply any arguments that start with a dash or double-dash, you're in composing mode, meaning you can write your entry on the command line or an editor of your choice. + +We intentionally break a convention on command line arguments: all arguments starting with a `single dash` will `filter` your journal before viewing it, and can be combined arbitrarily. Arguments with a `double dash` will control how your journal is displayed or exported and are mutually exclusive (ie. you can only specify one way to display or export your journal at a time). + + +Composing Entries +----------------- + +Composing mode is entered by either starting ``jrnl`` without any arguments -- which will prompt you to write an entry or launch your editor -- or by just writing an entry on the prompt, such as:: + + jrnl today at 3am: I just met Steve Buscemi in a bar! He looked funny. + + +Smart timestamps +~~~~~~~~~~~~~~~~ + +Timestamps that work: + +* at 6am +* yesterday +* last monday +* sunday at noon +* 2 march 2012 +* 7 apr +* 5/20/1998 at 23:42 + +Starring entries +~~~~~~~~~~~~~~~~ + +To mark an entry as a favourite, simply "star" it:: + + jrnl last sunday *: Best day of my life. + +If you don't want to add a date (ie. your entry will be dated as now), The following options are equivalent: + +* ``jrnl *: Best day of my life.`` +* ``jrnl *Best day of my life.`` +* ``jrnl Best day of my life.*`` + +.. note:: + + Just make sure that the asterisk sign is **not** surrounded by whitespaces, e.g. ``jrnl Best day of my life! *`` will **not** work (the reason being that the ``*`` sign has a special meaning on most shells). + +Viewing +------- + +:: + + jrnl -n 10 + +will list you the ten latest entries, :: + + jrnl -from "last year" -until march + +everything that happened from the start of last year to the start of last march. To only see your favourite entries, use :: + + jrnl -starred + +Using Tags +---------- + +Keep track of people, projects or locations, by tagging them with an ``@`` in your entries :: + + jrnl Had a wonderful day on the @beach with @Tom and @Anna. + +You can filter your journal entries just like this: :: + + jrnl @pinkie @WorldDomination + +Will print all entries in which either ``@pinkie`` or ``@WorldDomination`` occurred. :: + + jrnl -n 5 -and @pineapple @lubricant + +the last five entries containing both ``@pineapple`` **and** ``@lubricant``. You can change which symbols you'd like to use for tagging in the configuration. + +.. note:: + + ``jrnl @pinkie @WorldDomination`` will switch to viewing mode because although _no_ command line arguments are given, all the input strings look like tags - *jrnl* will assume you want to filter by tag. + diff --git a/gh_pages.py b/gh_pages.py new file mode 100644 index 00000000..82e4936a --- /dev/null +++ b/gh_pages.py @@ -0,0 +1,68 @@ +from fabric.api import * +from fabric.contrib.console import confirm + +def create_sphinx_pages(): + """ + Create a new branch with Sphinx documentation ready to be published + using GitHub's Pages system. + + Example usage: + + $ fab make_sphinx_branch + + Before you can publish your docs, you need to commit them to the repo. + + $ git add . + $ git commit -am "First commit" + + Then publish the files by pushing them up to GitHub. + + $ git push origin gh-pages + + Then the docs will appear on GitHub at: + + http://<your_account_name>.github.com/<your_repo_name>/ + + """ + # Create the new branch + local("git branch gh-pages") + # Move into it + local("git checkout gh-pages") + # Clear it out + local("git symbolic-ref HEAD refs/heads/gh-pages") + local("rm .git/index") + local("git clean -fdx") + # Install sphinx + local("pip install sphinx") + # Save the dependencies to the requirements file + local("pip freeze > requirements.txt") + # Warn the user of a quirk before configuring with Sphinx + confirm(""". ___ ___ _ ___ ___ _ + /\ | | |_ |\ | | | / \ |\ | + /--\ | | |_ | \| | _|_ \_/ | \| + +Sphinx is about to start configuring your project. + +You can accept the default settings it offers, EXCEPT ONE. + +The second question it will ask is: + +'Separate source and build directories (y/N) [n]:' + +YOU MUST ANSWER YES. THAT MEANS YOU TYPE 'Y' AND PRESS ENTER. + +DO YOU UNDERSTAND?""") + # Start up a Sphinx project + local("sphinx-quickstart") + # Create the .nojekyll file GitHub requires + local("touch .nojekyll") + # Make the patches to Sphinx's Makefile we need + local("echo '' >> Makefile") + local("echo 'BUILDDIR = ./' >> Makefile") + local("echo '' >> Makefile") + local("echo 'html:' >> Makefile") + local("echo '\t$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)' >> Makefile") + local("echo '\t@echo' >> Makefile") + local("echo '\t@echo \"Build finished. The HTML pages are in $(BUILDDIR)\"' >> Makefile") + # Make the branch for the first time + local("make html") diff --git a/jrnl/Entry.py b/jrnl/Entry.py new file mode 100644 index 00000000..4948cc1d --- /dev/null +++ b/jrnl/Entry.py @@ -0,0 +1,92 @@ +#!/usr/bin/env python +# encoding: utf-8 + +import re +import textwrap +from datetime import datetime + +class Entry: + def __init__(self, journal, date=None, title="", body="", starred=False): + self.journal = journal # Reference to journal mainly to access it's config + self.date = date or datetime.now() + self.title = title.strip() + self.body = body.strip() + self.tags = self.parse_tags() + self.starred = starred + + def parse_tags(self): + fulltext = " ".join([self.title, self.body]).lower() + tags = re.findall(r'(?u)([{tags}]\w+)'.format(tags=self.journal.config['tagsymbols']), fulltext, re.UNICODE) + self.tags = tags + return set(tags) + + def __unicode__(self): + """Returns a string representation of the entry to be written into a journal file.""" + date_str = self.date.strftime(self.journal.config['timeformat']) + title = date_str + " " + self.title + if self.starred: + title += " *" + body = self.body.strip() + + return u"{title}{sep}{body}\n".format( + title=title, + sep="\n" if self.body else "", + body=body + ) + + def pprint(self, short=False): + """Returns a pretty-printed version of the entry. + If short is true, only print the title.""" + date_str = self.date.strftime(self.journal.config['timeformat']) + if not short and self.journal.config['linewrap']: + title = textwrap.fill(date_str + " " + self.title, self.journal.config['linewrap']) + body = "\n".join([ + textwrap.fill(line+" ", + self.journal.config['linewrap'], + initial_indent="| ", + subsequent_indent="| ", + drop_whitespace=False).replace(' ', ' ') + for line in self.body.strip().splitlines() + ]) + else: + title = date_str + " " + self.title + body = self.body.strip() + + # Suppress bodies that are just blanks and new lines. + has_body = len(self.body) > 20 or not all(char in (" ", "\n") for char in self.body) + + if short: + return title + else: + return u"{title}{sep}{body}\n".format( + title=title, + sep="\n" if has_body else "", + body=body if has_body else "", + ) + + def __repr__(self): + return "<Entry '{0}' on {1}>".format(self.title.strip(), self.date.strftime("%Y-%m-%d %H:%M")) + + def to_dict(self): + return { + 'title': self.title.strip(), + 'body': self.body.strip(), + 'date': self.date.strftime("%Y-%m-%d"), + 'time': self.date.strftime("%H:%M"), + 'starred': self.starred + } + + def to_md(self): + date_str = self.date.strftime(self.journal.config['timeformat']) + body_wrapper = "\n\n" if self.body.strip() else "" + body = body_wrapper + self.body.strip() + space = "\n" + md_head = "###" + + return u"{md} {date}, {title} {body} {space}".format( + md=md_head, + date=date_str, + title=self.title, + body=body, + space=space + ) diff --git a/jrnl/Entry.pyc b/jrnl/Entry.pyc new file mode 100644 index 0000000000000000000000000000000000000000..0b01ad7f51513d7409bd08c056687edd1e815cc6 GIT binary patch literal 3864 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 Tz~lDHPpHAtd+TQ1-1PnfqLR@o literal 0 HcmV?d00001 diff --git a/jrnl/Journal.py b/jrnl/Journal.py new file mode 100644 index 00000000..9f922509 --- /dev/null +++ b/jrnl/Journal.py @@ -0,0 +1,366 @@ +#!/usr/bin/env python +# encoding: utf-8 + +try: from . import Entry +except (SystemError, ValueError): import Entry +try: from . import util +except (SystemError, ValueError): import util +import codecs +import os +try: import parsedatetime.parsedatetime_consts as pdt +except ImportError: import parsedatetime.parsedatetime as pdt +import re +from datetime import datetime +import time +import sys +try: + from Crypto.Cipher import AES + from Crypto import Random + crypto_installed = True +except ImportError: + crypto_installed = False +import hashlib +try: + import colorama + colorama.init() +except ImportError: + colorama = None +import plistlib +import pytz +import uuid + +class Journal(object): + def __init__(self, name='default', **kwargs): + self.config = { + 'journal': "journal.txt", + 'encrypt': False, + 'default_hour': 9, + 'default_minute': 0, + 'timeformat': "%Y-%m-%d %H:%M", + 'tagsymbols': '@', + 'highlight': True, + 'linewrap': 80, + } + self.config.update(kwargs) + # Set up date parser + consts = pdt.Constants(usePyICU=False) + consts.DOWParseStyle = -1 # "Monday" will be either today or the last Monday + self.dateparse = pdt.Calendar(consts) + self.key = None # used to decrypt and encrypt the journal + self.search_tags = None # Store tags we're highlighting + self.name = name + + journal_txt = self.open() + self.entries = self.parse(journal_txt) + self.sort() + + def _colorize(self, string): + if colorama: + return colorama.Fore.CYAN + string + colorama.Fore.RESET + else: + return string + + def _decrypt(self, cipher): + """Decrypts a cipher string using self.key as the key and the first 16 byte of the cipher as the IV""" + if not crypto_installed: + sys.exit("Error: PyCrypto is not installed.") + if not cipher: + return "" + crypto = AES.new(self.key, AES.MODE_CBC, cipher[:16]) + try: + plain = crypto.decrypt(cipher[16:]) + except ValueError: + util.prompt("ERROR: Your journal file seems to be corrupted. You do have a backup, don't you?") + sys.exit(1) + padding = " ".encode("utf-8") + if not plain.endswith(padding): # Journals are always padded + return None + else: + return plain.decode("utf-8") + + def _encrypt(self, plain): + """Encrypt a plaintext string using self.key as the key""" + if not crypto_installed: + sys.exit("Error: PyCrypto is not installed.") + Random.atfork() # A seed for PyCrypto + iv = Random.new().read(AES.block_size) + crypto = AES.new(self.key, AES.MODE_CBC, iv) + plain = plain.encode("utf-8") + plain += b" " * (AES.block_size - len(plain) % AES.block_size) + return iv + crypto.encrypt(plain) + + def make_key(self, password): + """Creates an encryption key from the default password or prompts for a new password.""" + self.key = hashlib.sha256(password.encode("utf-8")).digest() + + def open(self, filename=None): + """Opens the journal file defined in the config and parses it into a list of Entries. + Entries have the form (date, title, body).""" + filename = filename or self.config['journal'] + + if self.config['encrypt']: + with open(filename, "rb") as f: + journal_encrypted = f.read() + + def validate_password(password): + self.make_key(password) + return self._decrypt(journal_encrypted) + + # Soft-deprecated: + journal = None + if 'password' in self.config: + journal = validate_password(self.config['password']) + if not journal: + journal = util.get_password(keychain=self.name, validator=validate_password) + else: + with codecs.open(filename, "r", "utf-8") as f: + journal = f.read() + return journal + + def parse(self, journal): + """Parses a journal that's stored in a string and returns a list of entries""" + + # Entries start with a line that looks like 'date title' - let's figure out how + # long the date will be by constructing one + date_length = len(datetime.today().strftime(self.config['timeformat'])) + + # Initialise our current entry + entries = [] + current_entry = None + + for line in journal.splitlines(): + try: + # try to parse line as date => new entry begins + line = line.strip() + new_date = datetime.strptime(line[:date_length], self.config['timeformat']) + + # parsing successfull => save old entry and create new one + if new_date and current_entry: + entries.append(current_entry) + + if line.endswith("*"): + starred = True + line = line[:-1] + else: + starred = False + + current_entry = Entry.Entry(self, date=new_date, title=line[date_length+1:], starred=starred) + except ValueError: + # Happens when we can't parse the start of the line as an date. + # In this case, just append line to our body. + if current_entry: + current_entry.body += line + "\n" + + # Append last entry + if current_entry: + entries.append(current_entry) + for entry in entries: + entry.parse_tags() + return entries + + def __unicode__(self): + return self.pprint() + + def pprint(self, short=False): + """Prettyprints the journal's entries""" + sep = "\n" + pp = sep.join([e.pprint(short=short) for e in self.entries]) + if self.config['highlight']: # highlight tags + if self.search_tags: + for tag in self.search_tags: + tagre = re.compile(re.escape(tag), re.IGNORECASE) + pp = re.sub(tagre, + lambda match: self._colorize(match.group(0)), + pp, re.UNICODE) + else: + pp = re.sub(r"(?u)([{tags}]\w+)".format(tags=self.config['tagsymbols']), + lambda match: self._colorize(match.group(0)), + pp) + return pp + + def __repr__(self): + return "<Journal with {0} entries>".format(len(self.entries)) + + def write(self, filename=None): + """Dumps the journal into the config file, overwriting it""" + filename = filename or self.config['journal'] + journal = "\n".join([e.__unicode__() for e in self.entries]) + if self.config['encrypt']: + journal = self._encrypt(journal) + with open(filename, 'wb') as journal_file: + journal_file.write(journal) + else: + with codecs.open(filename, 'w', "utf-8") as journal_file: + journal_file.write(journal) + + def sort(self): + """Sorts the Journal's entries by date""" + self.entries = sorted(self.entries, key=lambda entry: entry.date) + + def limit(self, n=None): + """Removes all but the last n entries""" + if n: + self.entries = self.entries[-n:] + + def filter(self, tags=[], start_date=None, end_date=None, starred=False, strict=False, short=False): + """Removes all entries from the journal that don't match the filter. + + tags is a list of tags, each being a string that starts with one of the + tag symbols defined in the config, e.g. ["@John", "#WorldDomination"]. + + start_date and end_date define a timespan by which to filter. + + starred limits journal to starred entries + + If strict is True, all tags must be present in an entry. If false, the + entry is kept if any tag is present.""" + self.search_tags = set([tag.lower() for tag in tags]) + end_date = self.parse_date(end_date) + start_date = self.parse_date(start_date) + # If strict mode is on, all tags have to be present in entry + tagged = self.search_tags.issubset if strict else self.search_tags.intersection + result = [ + entry for entry in self.entries + if (not tags or tagged(entry.tags)) + and (not starred or entry.starred) + and (not start_date or entry.date > start_date) + and (not end_date or entry.date < end_date) + ] + if short: + if tags: + for e in self.entries: + res = [] + for tag in tags: + matches = [m for m in re.finditer(tag, e.body)] + for m in matches: + date = e.date.strftime(self.config['timeformat']) + excerpt = e.body[m.start():min(len(e.body), m.end()+60)] + res.append('{0} {1} ..'.format(date, excerpt)) + e.body = "\n".join(res) + else: + for e in self.entries: + e.body = '' + self.entries = result + + def parse_date(self, date_str): + """Parses a string containing a fuzzy date and returns a datetime.datetime object""" + if not date_str: + return None + elif isinstance(date_str, datetime): + return date_str + + date, flag = self.dateparse.parse(date_str) + + if not flag: # Oops, unparsable. + try: # Try and parse this as a single year + year = int(date_str) + return datetime(year, 1, 1) + except ValueError: + return None + except TypeError: + return None + + if flag is 1: # Date found, but no time. Use the default time. + date = datetime(*date[:3], hour=self.config['default_hour'], minute=self.config['default_minute']) + else: + date = datetime(*date[:6]) + + # Ugly heuristic: if the date is more than 4 weeks in the future, we got the year wrong. + # Rather then this, we would like to see parsedatetime patched so we can tell it to prefer + # past dates + dt = datetime.now() - date + if dt.days < -28: + date = date.replace(date.year - 1) + + return date + + def new_entry(self, raw, date=None, sort=True): + """Constructs a new entry from some raw text input. + If a date is given, it will parse and use this, otherwise scan for a date in the input first.""" + + raw = raw.replace('\\n ', '\n').replace('\\n', '\n') + starred = False + # Split raw text into title and body + title_end = len(raw) + for separator in ["\n", ". ", "? ", "! "]: + sep_pos = raw.find(separator) + if 1 < sep_pos < title_end: + title_end = sep_pos + title = raw[:title_end+1] + body = raw[title_end+1:].strip() + starred = False + if not date: + if title.find(":") > 0: + starred = "*" in title[:title.find(":")] + date = self.parse_date(title[:title.find(":")]) + if date or starred: # Parsed successfully, strip that from the raw text + title = title[title.find(":")+1:].strip() + elif title.strip().startswith("*"): + starred = True + title = title[1:].strip() + elif title.strip().endswith("*"): + starred = True + title = title[:-1].strip() + if not date: # Still nothing? Meh, just live in the moment. + date = self.parse_date("now") + entry = Entry.Entry(self, date, title, body, starred=starred) + self.entries.append(entry) + if sort: + self.sort() + return entry + + +class DayOne(Journal): + """A special Journal handling DayOne files""" + def __init__(self, **kwargs): + self.entries = [] + super(DayOne, self).__init__(**kwargs) + + def open(self): + files = [os.path.join(self.config['journal'], "entries", f) for f in os.listdir(os.path.join(self.config['journal'], "entries"))] + return files + + def parse(self, filenames): + """Instead of parsing a string into an entry, this method will take a list + of filenames, interpret each as a plist file and create a new entry from that.""" + self.entries = [] + for filename in filenames: + with open(filename, 'rb') as plist_entry: + dict_entry = plistlib.readPlist(plist_entry) + try: + timezone = pytz.timezone(dict_entry['Time Zone']) + except (KeyError, pytz.exceptions.UnknownTimeZoneError): + timezone = pytz.timezone(util.get_local_timezone()) + date = dict_entry['Creation Date'] + date = date + timezone.utcoffset(date) + entry = self.new_entry(raw=dict_entry['Entry Text'], date=date, sort=False) + entry.starred = dict_entry["Starred"] + entry.uuid = dict_entry["UUID"] + entry.tags = dict_entry.get("Tags", []) + # We're using new_entry to create the Entry object, which adds the entry + # to self.entries already. However, in the original Journal.__init__, this + # method is expected to return a list of newly created entries, which is why + # we're returning the obvious. + return self.entries + + def write(self): + """Writes only the entries that have been modified into plist files.""" + for entry in self.entries: + # Assumption: since jrnl can not manipulate existing entries, all entries + # that have a uuid will be old ones, and only the one that doesn't will + # have a new one! + if not hasattr(entry, "uuid"): + utc_time = datetime.utcfromtimestamp(time.mktime(entry.date.timetuple())) + new_uuid = uuid.uuid1().hex + filename = os.path.join(self.config['journal'], "entries", new_uuid+".doentry") + entry_plist = { + 'Creation Date': utc_time, + 'Starred': entry.starred if hasattr(entry, 'starred') else False, + 'Entry Text': entry.title+"\n"+entry.body, + 'Time Zone': util.get_local_timezone(), + 'UUID': new_uuid, + 'Tags': [tag.strip(self.config['tagsymbols']) for tag in entry.tags] + } + # print entry_plist + + plistlib.writePlist(entry_plist, filename) diff --git a/jrnl/Journal.pyc b/jrnl/Journal.pyc new file mode 100644 index 0000000000000000000000000000000000000000..e6f3a70703c2a158e5e523ff400ca37d03c4b8ae GIT binary patch literal 13843 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 WS;X-apHh<;AwEuN;ph+DJ^uybV?uKP literal 0 HcmV?d00001 diff --git a/jrnl/__init__.py b/jrnl/__init__.py new file mode 100644 index 00000000..14112f4d --- /dev/null +++ b/jrnl/__init__.py @@ -0,0 +1,17 @@ +#!/usr/bin/env python +# encoding: utf-8 + + +""" +jrnl is a simple journal application for your command line. +""" + +__title__ = 'jrnl' +__version__ = '1.6.3' +__author__ = 'Manuel Ebert' +__license__ = 'MIT License' +__copyright__ = 'Copyright 2013 Manuel Ebert' + +from . import Journal +from . import jrnl +from .jrnl import cli diff --git a/jrnl/__init__.pyc b/jrnl/__init__.pyc new file mode 100644 index 0000000000000000000000000000000000000000..5674b64dd3594e552eda305e05802b0628c74282 GIT binary patch literal 537 zcmYjOO;5ux40YSBUx2hbmmGUQEn^ZVKuCxKXyZ^oLb*hx2`p3ER85A|pUZFH58!m; zqfwvzo}JiEg0G|Wb2*eX>^~pvHU8!Wfdf!P52y#+2kHY4fCj)PKqtVbK&QY%;1Q@0 znh0nFp5yVzW1#VlC!k_z5}*n46dtn!SK$&N-Sn*@(vXT6*>p;fjo$WcrAXCvO4gN? zx+QPACj;uF)=g8joG96fJhc-%!5v_x=*;u;d|?jJTUG5=D02HMdTU&%)!h?W%38EW zm}BHOx*K}=zP9A-biN?}^QDLJ%z=#%?swgcLWz7I3ec;Se8^IC#ze-rt{Jll3TUKN z0*x!q*oWv1j)B~zGgfWwTKB(U9Mg4%{Adi<Ki#2%0+g<sv3TiTCv(~#m=mPMv%wk# w-VF|3biLk)+M2@M%?=oot+b5g-C$$faM5VKRpQFcXl4kZAA0-c&%BxU4Y3(_od5s; literal 0 HcmV?d00001 diff --git a/jrnl/exporters.py b/jrnl/exporters.py new file mode 100644 index 00000000..7d2eaa93 --- /dev/null +++ b/jrnl/exporters.py @@ -0,0 +1,110 @@ +#!/usr/bin/env python +# encoding: utf-8 + +import os +import string +try: from slugify import slugify +except ImportError: import slugify +try: import simplejson as json +except ImportError: import json +try: from .util import u +except (SystemError, ValueError): from util import u + + +def get_tags_count(journal): + """Returns a set of tuples (count, tag) for all tags present in the journal.""" + # Astute reader: should the following line leave you as puzzled as me the first time + # I came across this construction, worry not and embrace the ensuing moment of enlightment. + tags = [tag + for entry in journal.entries + for tag in set(entry.tags) + ] + # To be read: [for entry in journal.entries: for tag in set(entry.tags): tag] + tag_counts = set([(tags.count(tag), tag) for tag in tags]) + return tag_counts + +def to_tag_list(journal): + """Prints a list of all tags and the number of occurrences.""" + tag_counts = get_tags_count(journal) + result = "" + if not tag_counts: + return '[No tags found in journal.]' + elif min(tag_counts)[0] == 0: + tag_counts = filter(lambda x: x[0] > 1, tag_counts) + result += '[Removed tags that appear only once.]\n' + result += "\n".join(u"{0:20} : {1}".format(tag, n) for n, tag in sorted(tag_counts, reverse=True)) + return result + +def to_json(journal): + """Returns a JSON representation of the Journal.""" + tags = get_tags_count(journal) + result = { + "tags": dict((tag, count) for count, tag in tags), + "entries": [e.to_dict() for e in journal.entries] + } + return json.dumps(result, indent=2) + +def to_md(journal): + """Returns a markdown representation of the Journal""" + out = [] + year, month = -1, -1 + for e in journal.entries: + if not e.date.year == year: + year = e.date.year + out.append(str(year)) + out.append("=" * len(str(year)) + "\n") + if not e.date.month == month: + month = e.date.month + out.append(e.date.strftime("%B")) + out.append('-' * len(e.date.strftime("%B")) + "\n") + out.append(e.to_md()) + result = "\n".join(out) + return result + +def to_txt(journal): + """Returns the complete text of the Journal.""" + return journal.pprint() + +def export(journal, format, output=None): + """Exports the journal to various formats. + format should be one of json, txt, text, md, markdown. + If output is None, returns a unicode representation of the output. + If output is a directory, exports entries into individual files. + Otherwise, exports to the given output file. + """ + maps = { + "json": to_json, + "txt": to_txt, + "text": to_txt, + "md": to_md, + "markdown": to_md + } + if output and os.path.isdir(output): # multiple files + return write_files(journal, output, format) + else: + content = maps[format](journal) + if output: + try: + with open(output, 'w') as f: + f.write(content) + return "[Journal exported to {0}]".format(output) + except IOError as e: + return "[ERROR: {0} {1}]".format(e.filename, e.strerror) + else: + return content + +def write_files(journal, path, format): + """Turns your journal into separate files for each entry. + Format should be either json, md or txt.""" + make_filename = lambda entry: e.date.strftime("%C-%m-%d_{0}.{1}".format(slugify(u(e.title)), format)) + for e in journal.entries: + full_path = os.path.join(path, make_filename(e)) + if format == 'json': + content = json.dumps(e.to_dict(), indent=2) + "\n" + elif format == 'md': + content = e.to_md() + elif format == 'txt': + content = u(e) + with open(full_path, 'w') as f: + f.write(content) + return "[Journal exported individual files in {0}]".format(path) diff --git a/jrnl/exporters.pyc b/jrnl/exporters.pyc new file mode 100644 index 0000000000000000000000000000000000000000..59e5a0d3687f1effc89549f36047569624a51213 GIT binary patch literal 5040 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 literal 0 HcmV?d00001 diff --git a/jrnl/install.py b/jrnl/install.py new file mode 100644 index 00000000..0ff6159b --- /dev/null +++ b/jrnl/install.py @@ -0,0 +1,96 @@ +#!/usr/bin/env python +# encoding: utf-8 + +import readline +import glob +import getpass +try: import simplejson as json +except ImportError: import json +import os +try: from . import util +except (SystemError, ValueError): import util + + +def module_exists(module_name): + """Checks if a module exists and can be imported""" + try: + __import__(module_name) + except ImportError: + return False + else: + return True + +default_config = { + 'journals': { + "default": os.path.expanduser("~/journal.txt") + }, + 'editor': "", + 'encrypt': False, + 'default_hour': 9, + 'default_minute': 0, + 'timeformat': "%Y-%m-%d %H:%M", + 'tagsymbols': '@', + 'highlight': True, + 'linewrap': 80, +} + + +def upgrade_config(config, config_path=os.path.expanduser("~/.jrnl_conf")): + """Checks if there are keys missing in a given config dict, and if so, updates the config file accordingly. + This essentially automatically ports jrnl installations if new config parameters are introduced in later + versions.""" + missing_keys = set(default_config).difference(config) + if missing_keys: + for key in missing_keys: + config[key] = default_config[key] + with open(config_path, 'w') as f: + json.dump(config, f, indent=2) + print("[.jrnl_conf updated to newest version]") + + +def save_config(config=default_config, config_path=os.path.expanduser("~/.jrnl_conf")): + with open(config_path, 'w') as f: + json.dump(config, f, indent=2) + + +def install_jrnl(config_path='~/.jrnl_config'): + def autocomplete(text, state): + expansions = glob.glob(os.path.expanduser(text)+'*') + expansions = [e+"/" if os.path.isdir(e) else e for e in expansions] + expansions.append(None) + return expansions[state] + readline.set_completer_delims(' \t\n;') + readline.parse_and_bind("tab: complete") + readline.set_completer(autocomplete) + + # Where to create the journal? + path_query = 'Path to your journal file (leave blank for ~/journal.txt): ' + journal_path = util.py23_input(path_query).strip() or os.path.expanduser('~/journal.txt') + default_config['journals']['default'] = os.path.expanduser(journal_path) + + # Encrypt it? + if module_exists("Crypto"): + password = getpass.getpass("Enter password for journal (leave blank for no encryption): ") + if password: + default_config['encrypt'] = True + if util.yesno("Do you want to store the password in your keychain?", default=True): + util.set_keychain("default", password) + print("Journal will be encrypted.") + else: + password = None + print("PyCrypto not found. To encrypt your journal, install the PyCrypto package from http://www.pycrypto.org or with 'pip install pycrypto' and run 'jrnl --encrypt'. For now, your journal will be stored in plain text.") + + # Use highlighting: + if not module_exists("colorama"): + print("colorama not found. To turn on highlighting, install colorama and set highlight to true in your .jrnl_conf.") + default_config['highlight'] = False + + open(default_config['journals']['default'], 'a').close() # Touch to make sure it's there + + # Write config to ~/.jrnl_conf + with open(config_path, 'w') as f: + json.dump(default_config, f, indent=2) + config = default_config + if password: + config['password'] = password + return config diff --git a/jrnl/install.pyc b/jrnl/install.pyc new file mode 100644 index 0000000000000000000000000000000000000000..8156c6c9ede1c3f5c407868b1e80b6fb74060ef2 GIT binary patch literal 3902 zcmbtX-)|eo5uQE%kVK1$EXlEDJIFSzA~v;1AZd+O5z+uoQa4Bi_vF^Dij+O^mgG^# zyYubRGyy3u_IscEFZH$PdkXYF=zG&|=8lvUKeZNh%iX=%*_qjI=37?&-E92xtC`=U z@~@8XPx07K6j6wOMKRIwqOa&!&F4Kj_Gq>~A6DqNN>7q^sA_6-+MxW1lv1URD!)t= zJuSy|I<C`fi$agW3dKt_UZ&$^Qcsc}V*Lu42K7DB^4CjRL`Jk!=@rbnM$rmIicFnG zt2Am-SfiJ)uTJ;FB|OU%uF!q6MqvY^YZR{H3sP(NdW*t!d|jt-10oo0Vg!S3(Ea1} zOB&x6jW_8PT)$4{^;fs(6(X@g;WmZ0MQoG9cGS9qI7Z*$?+_*uwYYIrG!qxaJs$B> z!}9=-{Rx`c8abjf;yn?I4XQdNQFxD|;5<5d>MC?3>OEex$E$~?cWQOi*MT0V;UqTN zyoju`I!Hp@3le=|bTrP=+?nvO#TK{*nr^q4>~`HX41X;WpXWK`*r+dp*c!3-aXvAH z^(<Fx(M^J}X<<mxi1nS{S(Dq&I7lWY?qqp7GCgNIqdbX=CQ7Ue;<%m7T=POxVeA?v zESp7MMXjl(s(F@$zUhq8NuC68+r4mZ2{WPT2b0*jW%SE;7Eyy&j9wE)4j!<eNqYG# zbHE7Rt)eMcc8AayVN8y9ozIS=Wa5nFshvOU?Tq(!LcQ~Ff9E$6Ef<YVKh4L1!;v6K zipgMLXXBGJwvIO$MuTCD$3>4Y5(DEXG1ENAEbsqKr_I6W_R^%^<MZP<^Fjdt`+x`P zarz^#guyvF9_1OmxXYc-zTTqq3JaZ8Xd6hu*TJ**=m~If2Iyn4M}K*T&Z~^IQH`~n zRm(hk=_&OjtkQ3vB2j+zFoEw?0F}dL|HWo3kmQCYH#)#`YGziCBWt5%prZsB8${1d zqS=RNpu?!=?g`L<KbzjulPnAnMGXyenSKOF2EAUIhfosF+6|4r$HT~KW35SC1W?R$ zFmWlu8}($waJ8Dlg<S<Uc$FrCbA)uRI}36E(E)d2Eo5De9O#*ljg4VSF1tO41TSyP z=}iSHQ4;dzd=Q8BeYAhPIG)mvP`gxPJ7b+LReUY+Lbwq$<E|j6h>0L0jQV|qFzFR3 zlxEn8GjC+mq7zQWS&PqKOet4#eihwr7Pz5+wv2t34?=cDN1W)tLHaSsC)pqmLL+F5 z2JF9JpQ<-h9r?F`&s`-jWnULC{SX5#QkTKzF(3=b0;5GyFTh3&HUh}l`9psbt-pmv zqTXV~{w;2{xw(y|nB&^%-{t0Ap2PEh))|hd4W7@v{D_Ba3c)*Z_i|1~11ZZ~JGc@( zz+;h7oK>%g&K3JTg5MrzsN#Xp*L)xu$OB{*(zeV$5gyg)B~f-vC`_Ye8m*L6#i=}> zK_+7{&;$P327eu(EQ7)@m;Zz77bp&Nh9PnrDV={ysG=<1fGBbuG=~LCJo{3q{BL3a zh;50bQ56*D`zrGO*|(HH5+0#2G%>*&t+8hN9|AFA;<_karvt2U8<&jQ24h0kXp{X> zc!l}`1}%$DjocQEZm|4WjVTq3dVvGXp4Y|nKP#AYR%f>59nd>!y^Uxe3f%a7_&MVE zbDic$qZNpa5M|*<9Lh}&hDQTv;L6x4D<e*21oaZm{2_O6VmA{ktk9o4diFjq!U|MJ z1OYk}2Eg<7k$~?|vg-qBJ1qu-WbPnNPr$%Lsg<!LD8t0O$Uw9caG&sIWWy+zqz*D< zeJH|*X<`cIWyhQWm2vK)t~rCSluD#R$-Zwwt;{rBOMB@!i%}YX!5cAIl6qJD44Ewn zpjR3n3&FbJWFOVEkhLE}>=8;2*S#5NQkM*?rHHp;gIv-lagdy9u%W)f&OhGQuT!?q zJNptv=9ve~$f-R*_wxkBS!aQ@Q!s<5n{W2oK1r(QY@R0A$Cte3Z2nB_)YBkwY_kRV z8zG;CV(@@?g1Xro22t`$%XQ|<;#Q%jQ5^FHsZ?*mw*5O^KbjSm>LhhAZIXm-{di%- zmC)Rq6O?SbSeOO9(_mn9KTpSc=v=nn=}f0nTz=$MlD5-)pb^4pglO+(QMOPsm)I3v z%_oW86&~E%D~;T3>o2e}NvHR&Sh8?Nq96>I#qd}&;M#H@>7{WB#tiH!oSYB7=cL1Z zOQ(sxxXvVl3nv$g_;v{fyb$B~JKPnSc_rc(blUc>V?Tj*@I4X`v*w2-RX}EP6NG$u zLO}t1jRQ>;5Y4-xiKDR<<^}y*(}gA76R^45DzC`;Sj^Q3wRiU6N8KpNCiBe8qs-sI z3!j<K-{po&kk2TU>*K&UHp`cc<!qf93p8+g@g8$H`5*AA1(Qi$_u|x=OPt2=FX*g; zUSSWCtov+Y@|kEXkuS9GGp>dBeCEM7U_Z9CyghXpLO;jY{uB+Vm0A;}pjoM_U3I&% zs@?+WH`EQasjhi-Rl`h8HN86(z68|eLeS!q@OicWBX0K5h$|MqBVxlho5E!-l0|6w z(oh@$=j#zJFlJo*!r&wMeGpHK3?=B74nm^IaW9TUbMFV-e2V5G9@6`te|m61Iw*d{ pe8PK3KvorhDzvVec(}KvHfg=GvQkkMb<<l?mp_f_t>&HDe*sf`i*En` literal 0 HcmV?d00001 diff --git a/jrnl/jrnl.py b/jrnl/jrnl.py new file mode 100755 index 00000000..901507c2 --- /dev/null +++ b/jrnl/jrnl.py @@ -0,0 +1,223 @@ +#!/usr/bin/env python +# encoding: utf-8 + +""" + jrnl + + license: MIT, see LICENSE for more details. +""" + +try: + from . import Journal + from . import util + from . import exporters + from . import install +except (SystemError, ValueError): + import Journal + import util + import exporters + import install +import os +import tempfile +import subprocess +import argparse +import sys + +xdg_config = os.environ.get('XDG_CONFIG_HOME') +CONFIG_PATH = os.path.join(xdg_config, "jrnl") if xdg_config else os.path.expanduser('~/.jrnl_config') +PYCRYPTO = install.module_exists("Crypto") + + +def parse_args(args=None): + parser = argparse.ArgumentParser() + composing = parser.add_argument_group('Composing', 'To write an entry simply write it on the command line, e.g. "jrnl yesterday at 1pm: Went to the gym."') + composing.add_argument('text', metavar='', nargs="*") + + reading = parser.add_argument_group('Reading', 'Specifying either of these parameters will display posts of your journal') + reading.add_argument('-from', dest='start_date', metavar="DATE", help='View entries after this date') + reading.add_argument('-until', '-to', dest='end_date', metavar="DATE", help='View entries before this date') + reading.add_argument('-and', dest='strict', action="store_true", help='Filter by tags using AND (default: OR)') + reading.add_argument('-starred', dest='starred', action="store_true", help='Show only starred entries') + reading.add_argument('-n', dest='limit', default=None, metavar="N", help='Shows the last n entries matching the filter', nargs="?", type=int) + + exporting = parser.add_argument_group('Export / Import', 'Options for transmogrifying your journal') + exporting.add_argument('--short', dest='short', action="store_true", help='Show only titles or line containing the search tags') + exporting.add_argument('--tags', dest='tags', action="store_true", help='Returns a list of all tags and number of occurences') + exporting.add_argument('--export', metavar='TYPE', dest='export', help='Export your journal to Markdown, JSON or Text', default=False, const=None) + exporting.add_argument('-o', metavar='OUTPUT', dest='output', help='The output of the file can be provided when using with --export', default=False, const=None) + exporting.add_argument('--encrypt', metavar='FILENAME', dest='encrypt', help='Encrypts your existing journal with a new password', nargs='?', default=False, const=None) + exporting.add_argument('--decrypt', metavar='FILENAME', dest='decrypt', help='Decrypts your journal and stores it in plain text', nargs='?', default=False, const=None) + exporting.add_argument('--delete-last', dest='delete_last', help='Deletes the last entry from your journal file.', action="store_true") + + return parser.parse_args(args) + +def guess_mode(args, config): + """Guesses the mode (compose, read or export) from the given arguments""" + compose = True + export = False + if args.decrypt is not False or args.encrypt is not False or args.export is not False or any((args.short, args.tags, args.delete_last)): + compose = False + export = True + elif any((args.start_date, args.end_date, args.limit, args.strict, args.starred)): + # Any sign of displaying stuff? + compose = False + elif args.text and all(word[0] in config['tagsymbols'] for word in " ".join(args.text).split()): + # No date and only tags? + compose = False + + return compose, export + +def get_text_from_editor(config): + tmpfile = os.path.join(tempfile.gettempdir(), "jrnl") + subprocess.call(config['editor'].split() + [tmpfile]) + if os.path.exists(tmpfile): + with open(tmpfile) as f: + raw = f.read() + os.remove(tmpfile) + else: + util.prompt('[Nothing saved to file]') + raw = '' + + return raw + + +def encrypt(journal, filename=None): + """ Encrypt into new file. If filename is not set, we encrypt the journal file itself. """ + password = util.getpass("Enter new password: ") + journal.make_key(password) + journal.config['encrypt'] = True + journal.write(filename) + if util.yesno("Do you want to store the password in your keychain?", default=True): + util.set_keychain(journal.name, password) + util.prompt("Journal encrypted to {0}.".format(filename or journal.config['journal'])) + +def decrypt(journal, filename=None): + """ Decrypts into new file. If filename is not set, we encrypt the journal file itself. """ + journal.config['encrypt'] = False + journal.config['password'] = "" + journal.write(filename) + util.prompt("Journal decrypted to {0}.".format(filename or journal.config['journal'])) + +def touch_journal(filename): + """If filename does not exist, touch the file""" + if not os.path.exists(filename): + util.prompt("[Journal created at {0}]".format(filename)) + open(filename, 'a').close() + +def update_config(config, new_config, scope, force_local=False): + """Updates a config dict with new values - either global if scope is None + or config['journals'][scope] is just a string pointing to a journal file, + or within the scope""" + if scope and type(config['journals'][scope]) is dict: # Update to journal specific + config['journals'][scope].update(new_config) + elif scope and force_local: # Convert to dict + config['journals'][scope] = {"journal": config['journals'][scope]} + config['journals'][scope].update(new_config) + else: + config.update(new_config) + +def cli(manual_args=None): + if not os.path.exists(CONFIG_PATH): + config = install.install_jrnl(CONFIG_PATH) + else: + config = util.load_and_fix_json(CONFIG_PATH) + install.upgrade_config(config, config_path=CONFIG_PATH) + + original_config = config.copy() + # check if the configuration is supported by available modules + if config['encrypt'] and not PYCRYPTO: + util.prompt("According to your jrnl_conf, your journal is encrypted, however PyCrypto was not found. To open your journal, install the PyCrypto package from http://www.pycrypto.org.") + sys.exit(1) + + args = parse_args(manual_args) + + # If the first textual argument points to a journal file, + # use this! + journal_name = args.text[0] if (args.text and args.text[0] in config['journals']) else 'default' + if journal_name is not 'default': + args.text = args.text[1:] + journal_conf = config['journals'].get(journal_name) + if type(journal_conf) is dict: # We can override the default config on a by-journal basis + config.update(journal_conf) + else: # But also just give them a string to point to the journal file + config['journal'] = journal_conf + config['journal'] = os.path.expanduser(config['journal']) + touch_journal(config['journal']) + mode_compose, mode_export = guess_mode(args, config) + + # open journal file or folder + if os.path.isdir(config['journal']): + if config['journal'].strip("/").endswith(".dayone") or \ + "entries" in os.listdir(config['journal']): + journal = Journal.DayOne(**config) + else: + util.prompt("[Error: {0} is a directory, but doesn't seem to be a DayOne journal either.".format(config['journal'])) + sys.exit(1) + else: + journal = Journal.Journal(journal_name, **config) + + if mode_compose and not args.text: + if config['editor']: + raw = get_text_from_editor(config) + else: + raw = util.py23_input("[Compose Entry] ") + if raw: + args.text = [raw] + else: + mode_compose = False + + # Writing mode + if mode_compose: + raw = " ".join(args.text).strip() + if util.PY2 and type(raw) is not unicode: + raw = raw.decode(sys.getfilesystemencoding()) + entry = journal.new_entry(raw) + util.prompt("[Entry added to {0} journal]".format(journal_name)) + journal.write() + else: + journal.filter(tags=args.text, + start_date=args.start_date, end_date=args.end_date, + strict=args.strict, + short=args.short, + starred=args.starred) + journal.limit(args.limit) + + # Reading mode + if not mode_compose and not mode_export: + print(journal.pprint()) + + # Various export modes + elif args.short: + print(journal.pprint(short=True)) + + elif args.tags: + print(exporters.to_tag_list(journal)) + + elif args.export is not False: + print(exporters.export(journal, args.export, args.output)) + + elif (args.encrypt is not False or args.decrypt is not False) and not PYCRYPTO: + util.prompt("PyCrypto not found. To encrypt or decrypt your journal, install the PyCrypto package from http://www.pycrypto.org.") + + elif args.encrypt is not False: + encrypt(journal, filename=args.encrypt) + # Not encrypting to a separate file: update config! + if not args.encrypt: + update_config(original_config, {"encrypt": True}, journal_name, force_local=True) + install.save_config(original_config, config_path=CONFIG_PATH) + + elif args.decrypt is not False: + decrypt(journal, filename=args.decrypt) + # Not decrypting to a separate file: update config! + if not args.decrypt: + update_config(original_config, {"encrypt": False}, journal_name, force_local=True) + install.save_config(original_config, config_path=CONFIG_PATH) + + elif args.delete_last: + last_entry = journal.entries.pop() + util.prompt("[Deleted Entry:]") + print(last_entry.pprint()) + journal.write() + +if __name__ == "__main__": + cli() diff --git a/jrnl/jrnl.pyc b/jrnl/jrnl.pyc new file mode 100644 index 0000000000000000000000000000000000000000..04d7e3e938780b3f1c2db033c64d9c4659a1c930 GIT binary patch literal 9065 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 literal 0 HcmV?d00001 diff --git a/jrnl/util.py b/jrnl/util.py new file mode 100644 index 00000000..7d396f72 --- /dev/null +++ b/jrnl/util.py @@ -0,0 +1,119 @@ +#!/usr/bin/env python +# encoding: utf-8 +import sys +import os +from tzlocal import get_localzone +import getpass as gp +import keyring +import pytz +try: import simplejson as json +except ImportError: import json +import re + +PY3 = sys.version_info[0] == 3 +PY2 = sys.version_info[0] == 2 +STDIN = sys.stdin +STDERR = sys.stderr +STDOUT = sys.stdout +TEST = False +__cached_tz = None + +def getpass(prompt="Password: "): + if not TEST: + return gp.getpass(prompt) + else: + return py23_input(prompt) + +def get_password(validator, keychain=None, max_attempts=3): + pwd_from_keychain = keychain and get_keychain(keychain) + password = pwd_from_keychain or getpass() + result = validator(password) + # Password is bad: + if not result and pwd_from_keychain: + set_keychain(keychain, None) + attempt = 1 + while not result and attempt < max_attempts: + prompt("Wrong password, try again.") + password = getpass() + result = validator(password) + attempt += 1 + if result: + return result + else: + prompt("Extremely wrong password.") + sys.exit(1) + +def get_keychain(journal_name): + return keyring.get_password('jrnl', journal_name) + +def set_keychain(journal_name, password): + if password is None: + try: + keyring.delete_password('jrnl', journal_name) + except: + pass + elif not TEST: + keyring.set_password('jrnl', journal_name, password) + +def u(s): + """Mock unicode function for python 2 and 3 compatibility.""" + return s if PY3 or type(s) is unicode else unicode(s, "unicode_escape") + +def prompt(msg): + """Prints a message to the std err stream defined in util.""" + if not msg.endswith("\n"): + msg += "\n" + STDERR.write(u(msg)) + +def py23_input(msg): + STDERR.write(u(msg)) + return STDIN.readline().strip() + +def yesno(prompt, default=True): + prompt = prompt.strip() + (" [Y/n]" if default else " [y/N]") + raw = py23_input(prompt) + return {'y': True, 'n': False}.get(raw.lower(), default) + +def get_local_timezone(): + """Returns the Olson identifier of the local timezone. + In a happy world, tzlocal.get_localzone would do this, but there's a bug on OS X + that prevents that right now: https://github.com/regebro/tzlocal/issues/6""" + global __cached_tz + if not __cached_tz and "darwin" in sys.platform: + __cached_tz = os.popen("systemsetup -gettimezone").read().replace("Time Zone: ", "").strip() + if not __cached_tz or __cached_tz not in pytz.all_timezones_set: + link = os.readlink("/etc/localtime") + # This is something like /usr/share/zoneinfo/America/Los_Angeles. + # Find second / from right and take the substring + __cached_tz = link[link.rfind('/', 0, link.rfind('/'))+1:] + elif not __cached_tz: + __cached_tz = str(get_localzone()) + if not __cached_tz or __cached_tz not in pytz.all_timezones_set: + __cached_tz = "UTC" + return __cached_tz + +def load_and_fix_json(json_path): + """Tries to load a json object from a file. + If that fails, tries to fix common errors (no or extra , at end of the line). + """ + with open(json_path) as f: + json_str = f.read() + config = fixed = None + try: + return json.loads(json_str) + except ValueError as e: + # Attempt to fix extra , + json_str = re.sub(r",[ \n]*}", "}", json_str) + # Attempt to fix missing , + json_str = re.sub(r"([^{,]) *\n *(\")", r"\1,\n \2", json_str) + try: + config = json.loads(json_str) + with open(json_path, 'w') as f: + json.dump(config, f, indent=2) + prompt("[Some errors in your jrnl config have been fixed for you.]") + return config + except ValueError as e: + prompt("[There seems to be something wrong with your jrnl config at {0}: {1}]".format(json_path, e.message)) + prompt("[Entry was NOT added to your journal]") + sys.exit(1) + diff --git a/jrnl/util.pyc b/jrnl/util.pyc new file mode 100644 index 0000000000000000000000000000000000000000..6d15e9d32b296995810774dda5efc3139ecae8da GIT binary patch literal 4864 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 literal 0 HcmV?d00001