Skip to main content

Use Jupyter notebooks to publish with Hugo.

Project description

https://img.shields.io/pypi/v/hugo_jupyter.svg https://img.shields.io/travis/knowsuchagency/hugo_jupyter.svg Updates https://img.shields.io/github/license/mashape/apistatus.svg

Publish Jupyter notebooks with Hugo.

Installation

pip install hugo_jupyter

Usage

example_movie.gif
cd root_of_hugo_project
hugo_jupyter --init

This will create a notebooks directory at the root of your hugo project if it doesn’t yet exist. Any jupyter notebooks you want rendered should go in the notebooks directory.

In addition, a fabfile.py script will be written at the project root.

fab serve

Automatically initializes your jupyter server, hugo server, and watchdog to re-render your jupyter notebooks to markdown for hugo as you create and edit them.

Jupyter Notebooks

Any notebooks that you create will need front matter for hugo to know how to render the content.

Once you edit the name of the jupyter notebook to something other than Untitled*.ipynb, hugo-jupyter will automatically edit the notebook’s metadata to enable rendering with jupyter. You may need to reload the notebook page to see the changes in the metadata.

There will also be a hugo-jupyter dictionary in the notebook’s metadata with a render-to field automatically set to content/post/. You can edit this field to edit where the notebook’s markdown will be rendered to.

http://i.imgur.com/ynQs0gB.png http://i.imgur.com/Jcjwc0y.png

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hugo_jupyter-1.0.2.tar.gz (201.5 kB view details)

Uploaded Source

Built Distribution

hugo_jupyter-1.0.2-py2.py3-none-any.whl (11.6 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file hugo_jupyter-1.0.2.tar.gz.

File metadata

File hashes

Hashes for hugo_jupyter-1.0.2.tar.gz
Algorithm Hash digest
SHA256 b3991ea0c9d22acf45919ea03f64a4952e8775eb46ee2a05a4b6e012b749bdd6
MD5 28d74cb3005301a791645a97aec76728
BLAKE2b-256 1470158041c90c022f7091ce9ae969809b23db88cb2cf68780706198656acc06

See more details on using hashes here.

File details

Details for the file hugo_jupyter-1.0.2-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for hugo_jupyter-1.0.2-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 cdf27ff0eddf0116f8ee7f5aaa2601c4da13996e5214518e888755389214538c
MD5 50d5a62234d4c2834f40766e7d199ee4
BLAKE2b-256 a2a5b85ff77104b31cb6601509ee26882db4c9a1bbc8e5e55a484fbfffc84c3c

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page