sphinx.ext.ext.todo
– Prise en charge des éléments todo¶
Auteur du module : Daniel Bültmann
Added in version 0.5.
Il existe deux directives supplémentaires quand vous utilisez cette extension :
- .. todo::¶
Utilisez cette directive comme, par exemple,
note
.Il n’apparaîtra dans la sortie que si
todo_include_todos' est ``True`
.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.