Skip to main content

A generic “todo like” nodes.

You love sphinx-ext-todo, and want more directives like this ?

This extension is for you.

install me with zc.buildout| pip | easy_install or clone and setup.py install|develop and add this to your conf.py

extensions = ['sphinxcontrib.gen_node']
gen_nodes = [('sample_one', True, True, False), ('sample_two', True, False, False),]

explanations

gen_nodes is a list of tuples which for each element you could now add in your documentation like you do with ‘sphinx-ext-todo’:

  • a new sample_one directive

    .. sample_one::  one thing
  • a new sample_onelist directive

    .. sample_onelist::

The sample_onelist will not appear in your documentation if you set False in your conf.py gen_nodes = [(‘sample_one’, False, False, False),… on the second argument.

options :

  • sample_one is the name of your new admonition, you’ll write

    .. sample_one:: A text here
  • The first (True|False) argument enables the list Plz note that the form of a “list directive is always ‘namenode’+list ie

    .. sample_onelist::
  • the second (True|False) renders gathering by doc subtitle

  • the third (True|False) renders a paragraph with filename and line number (like on todo-list) with sphinxext.todo

install me

easy_install

easy_install sphinxcontrib-gen_node

pip

pip install Sphinx
pip sphinxcontrib-gen_node

zc.buildout

eggs =
    Sphinx
    sphinxcontrib-gen_node

update your source/conf.py:

extensions = ['sphinxcontrib.gen_node']
gen_nodes = [('sample_one', True, True, False), ('sample_two', True, False, False)]

Credits

Companies

makinacom

Changelog

0.1 (2013-10-31)

  • Jean-Philippe Camguilhem <jean-philippe.camguilhem__at__makina-corpus.com>

Contributors

Jean-Philippe Camguilhem, Author

Metadata

Release files for sphinxcontrib-gen_node 0.1-20131031

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sphinxcontrib-gen_node 0.1-20131031
File Size Uploaded
sphinxcontrib-gen_node-0.1-20131031.zip 12.0 kB Details

Release files / sphinxcontrib-gen_node-0.1-20131031.zip

Download URL sphinxcontrib-gen_node-0.1-20131031.zip
Size 12.0 kB
Tags Source
SHA-256 checksum
How to use checksums
4f4d6e62facbe81a28d33ec06b3685679d2302ee4b66b84af85a487ed1568187
BLAKE2b-256 checksum
How to use checksums
e6fe9e3d354cfb43e0a52f0dbe830faf6ec710b66d97a0c862dfb1ad78d8bdb9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.1-20131031 This release

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page