A small Sphinx extension to enable tags and archive in documentation such as for a blog.
Project description
Sphinx nbblog
A small Sphinx extension to enable tags and archive in documentation such as for a blog.
Table of Contents
Installation
pip install sphinx-nbblog
Usage
Add sphinx-nbblog
somewhere in the extensions
list in conf.py
extensions = [
...
"sphinx_nbblog",
]
In an .rst file or in a .ipynb raw rst cell:
.. nbblog::
:abstract: what is this about
:date: 2023-09-23
:tags: yes, no, maybe
In another file, such as archive.rst
Archive
=======
.. archive::
The abstract currently does nothing but at some point I will probably make it visible in the archive page.
Development
I use Hatch, pyenv, and LunarVim
hatch run lvim
Test
After installing the python versions with pyenv, run:
hatch run test:test
License
sphinx-nbblog
is distributed under the terms of the MIT license.
Notes
This project is based on sphinx-tags
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
sphinx_nbblog-0.0.1.tar.gz
(12.2 kB
view hashes)
Built Distribution
Close
Hashes for sphinx_nbblog-0.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 365ce295fbb58434006e82b1d2fdd42dd954d5f735585f2a59db30c0052ff451 |
|
MD5 | 15586f05ec9371862fc5d4e7df054f35 |
|
BLAKE2b-256 | a500a8aa4ced7107e21340fe14d05b9e642df82dbe3fad3d218605dd09247012 |