sphinx.ext.todo
– Support for todo items¶
Autor del módulo: Daniel Bültmann
Added in version 0.5.
There are two additional directives when using this extension:
- .. todo::¶
Use this directive like, for example,
note
.It will only show up in the output if
todo_include_todos
isTrue
.Added in version 1.3.2: This directive supports an
class
option that determines the class attribute for HTML output. If not given, the class defaults toadmonition-todo
.
- .. todolist::¶
This directive is replaced by a list of all todo directives in the whole documentation, if
todo_include_todos
isTrue
.
These can be configured as seen below.
Configuration¶
- todo_include_todos¶
If this is
True
,todo
andtodolist
produce output, else they produce nothing. The default isFalse
.
- todo_emit_warnings¶
If this is
True
,todo
emits a warning for each TODO entries. The default isFalse
.Added in version 1.5.
- todo_link_only¶
If this is
True
,todolist
produce output without file path and line, The default isFalse
.Added in version 1.4.
autodoc provides the following an additional event:
- todo-defined(app, node)¶
Added in version 1.5.
Emitted when a todo is defined. node is the defined
sphinx.ext.todo.todo_node
node.