sphinx.ext.todo – Todoアイテムのサポート

モジュールの作者: Daniel Bültmann

バージョン 0.5 で追加.

この拡張を使用すると、以下の二つのディレクティブが追加されます:

.. todo::

このディレクティブは note と同じように使用できます。

このディレクティブの内容は todo_include_todosTrue の場合だけ表示されます。

バージョン 1.3.2 で追加: このディレクティブはHTML中のclass属性を指定するための``class``オプションをサポートします。指定しない場合、``admonition-todo``が適用されます。

.. todolist::

このディレクティブは、全ドキュメントのすべてのtodoディレクティブを含むリストで置換されます。 todo_include_todosTrue になったときだけ表示されます。

この拡張機能によって以下の設定値が追加されます。

todo_include_todos

もしもこの設定値がTrueに設定されると、todotodolistのディレクティブが出力を出すようになります。Falseが設定されると何も出力されなくなります。デフォルトはFalseです。

todo_emit_warnings

この設定値が True に設定されると、 todo は各TODOエントリーに警告を出します。デフォルトは False です。

バージョン 1.5 で追加.

この設定値が True に設定されると、 todolist はファイルパスと行を含めずに出力を出します。デフォルトは False です。

バージョン 1.4 で追加.

autodoc では以下の追加イベントが提供されます:

todo-defined(app, node)

バージョン 1.5 で追加.

todoが定義されたら発生します。 nodesphinx.ext.todo.todo_node です。