diff options
Diffstat (limited to 'doc/markup/misc.rst')
| -rw-r--r-- | doc/markup/misc.rst | 24 |
1 files changed, 24 insertions, 0 deletions
diff --git a/doc/markup/misc.rst b/doc/markup/misc.rst index 98f5485e..01e5a3f1 100644 --- a/doc/markup/misc.rst +++ b/doc/markup/misc.rst @@ -3,6 +3,8 @@ Miscellaneous markup ==================== +.. _metadata: + File-wide metadata ------------------ @@ -46,6 +48,28 @@ Meta-information markup output. +.. _tags: + +Including content based on tags +------------------------------- + +.. directive:: .. only:: <expression> + + Include the content of the directive only if the *expression* is true. The + expression should consist of tags, like this:: + + .. only:: html and draft + + Undefined tags are false, defined tags (via the ``-t`` command-line option or + within :file:`conf.py`) are true. Boolean expressions, also using + parentheses (like ``html and (latex or draft)`` are supported. + + The format of the current builder (``html``, ``latex`` or ``text``) is always + set as a tag. + + .. versionadded:: 0.6 + + Tables ------ |