Skip to content

jpcw/sphinxcontrib-gen_node

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

sphinxcontrib-gen_node

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

_

About

A generic "todo like" nodes extension

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages