Metadata-Version: 2.1
Name: jpy-flette
Version: 0.1.0
Summary: Static site generator for jupyter notebooks
Home-page: https://github.com/r4lv/jpy-flette
Author: Ralf Farkas
Author-email: r4lv@peaxels.com
License: MIT
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Framework :: Jupyter
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Documentation
Classifier: Environment :: Console
Requires-Python: >=3.5.0
Requires-Dist: nbconvert
Requires-Dist: click
Requires-Dist: jinja2
Requires-Dist: pyquery
Requires-Dist: ipython
Requires-Dist: pyyaml


jpy-flette
==========

*jpy-flette* is a lightweight (~150 lines) python static website generator which uses jupyter notebooks as input. It's fantastic for documenting scientific projects, documentation, or just to share your thoughts with the world.

Installation
------------

Install *jpy-flette* with pip:

.. code:: bash

    pip install jpy-flette


You could also download or clone the source code from the `repository <https://github.com/r4lv/jpy-flette>`_, then run

.. code:: bash

    python setup.py install




Usage
-----

    Make sure you check the `documentation <https://r4lv.github.io/jpy-flette>`_, which is actually built using *jpy-flette* itself!

*jpy-flette* transforms a directory full of ``.ipynb`` jupyter notebooks into a website with multiple pages. Let's assume the following directory structure:

.. code:: text

    ~/my/directory
              └── notebooks
                  ├── 00.index.ipynb
                  └── 01.jpy-flette-documentation.ipynb

After calling

.. code:: bash

    jpy-flette ~/my/directory/notebooks

you would obtain

.. code:: text

    ~/my/directory
              ├── docs
              │   ├── index.html
              │   ├── jpy-flette-documentation.html
              │   └── static
              │       ├── style.css
              │       └── script.js
              └── notebooks
                  ├── 00.index.ipynb
                  └── 01.jpy-flette-documentation.ipynb


``~/my/directory/docs`` is then ready to be published!

*jpy-flette* can be configured using ``fletteconf.yaml`` files for *theming*, titles/footers and more. Refer the `documentation <https://r4lv.github.io/jpy-flette>`_ for more.

