mirror of
https://github.com/sphinx-doc/sphinx.git
synced 2025-02-25 18:55:22 -06:00
44 lines
1.2 KiB
ReStructuredText
44 lines
1.2 KiB
ReStructuredText
:mod:`sphinx.ext.todo` -- Support for todo items
|
|
================================================
|
|
|
|
.. module:: sphinx.ext.todo
|
|
:synopsis: Allow inserting todo items into documents.
|
|
.. moduleauthor:: Daniel Bültmann
|
|
|
|
.. versionadded:: 0.5
|
|
|
|
There are two additional directives when using this extension:
|
|
|
|
.. rst:directive:: todo
|
|
|
|
Use this directive like, for example, :rst:dir:`note`.
|
|
|
|
It will only show up in the output if :confval:`todo_include_todos` is
|
|
``True``.
|
|
|
|
.. versionadded:: 1.3.2
|
|
This directive supports an ``class`` option that determines the class attribute
|
|
for HTML output. If not given, the class defaults to ``admonition-todo``.
|
|
|
|
|
|
.. rst:directive:: todolist
|
|
|
|
This directive is replaced by a list of all todo directives in the whole
|
|
documentation, if :confval:`todo_include_todos` is ``True``.
|
|
|
|
|
|
There is also an additional config value:
|
|
|
|
.. confval:: todo_include_todos
|
|
|
|
If this is ``True``, :rst:dir:`todo` and :rst:dir:`todolist` produce output,
|
|
else they produce nothing. The default is ``False``.
|
|
|
|
.. confval:: todo_link_only
|
|
|
|
If this is ``True``, :rst:dir:`todolist` produce output without file path and line,
|
|
The default is ``False``.
|
|
|
|
.. versionadded:: 1.4
|
|
|