Use Jupyter notebooks to publish with Hugo.
Project description
Publish Jupyter notebooks with Hugo.
Documentation: https://knowsuchagency.github.io/hugo_jupyter
Installation
pip install hugo_jupyter
Usage
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.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file hugo_jupyter-1.0.2.tar.gz
.
File metadata
- Download URL: hugo_jupyter-1.0.2.tar.gz
- Upload date:
- Size: 201.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | b3991ea0c9d22acf45919ea03f64a4952e8775eb46ee2a05a4b6e012b749bdd6 |
|
MD5 | 28d74cb3005301a791645a97aec76728 |
|
BLAKE2b-256 | 1470158041c90c022f7091ce9ae969809b23db88cb2cf68780706198656acc06 |
File details
Details for the file hugo_jupyter-1.0.2-py2.py3-none-any.whl
.
File metadata
- Download URL: hugo_jupyter-1.0.2-py2.py3-none-any.whl
- Upload date:
- Size: 11.6 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | cdf27ff0eddf0116f8ee7f5aaa2601c4da13996e5214518e888755389214538c |
|
MD5 | 50d5a62234d4c2834f40766e7d199ee4 |
|
BLAKE2b-256 | a2a5b85ff77104b31cb6601509ee26882db4c9a1bbc8e5e55a484fbfffc84c3c |