1. All non-anonymous internal targets, exported as ::

  .. _<targetName>: <base-file><ext>.<suffix>#<targetID>

Here <base-file> is the base file name (file name without extension).

2. All citations, exported as::

.. _<citationName>: <base-file><ext>.<suffix>#<citationID>

3. Substitution definitions that have the same names as internal targets but do not, directly or indirectly through substitution references, define internal target or refer to external references or footnotes.

4. Definition of substitutions referred to by the substitutions exported according to 3. Substitution definitions are exported as defined in the source file.

5. If -W xref-sections is specified,

a. Targets for all section titles, exported as ::

     .. _<base-file>.<base-title>: <base-file><ext>.<suffix>#<titleID>

   Here <base-title> is the title name prior to any autonumbering.

b. Substitution definitions for all section titles, exported as ::

     .. |<base-file>.<base-title>| replace:: <section-title>

c. Target for the file itself, exported as ::

     .. _<base-file>.: <sourceFileName><ext>.<suffix>

d. Substitution definition for the file itself, exported as ::

    .. |<base-file>.| replace:: <document-title>

6. If -W xref-role-targets is specified, then inline targets that are defined through an interpreted text target role are included in the index.

This writer uses the following output definitions:

-W appendix=<string> String to use for an appendix reference when xref-sections=1 (default "Appendix"). An appendix is a document with a "number-prefixed" title that is not a number. -W chapter=<string> String to use for a chapter reference when xref-sections=1 (default "Chapter"). A chapter is a document with a "number-prefixed" title that is a number. -W file-suffix=<suffix> Specify a file suffix to be used for exporting the cross reference targets (default is html). -W filename-ext=<ext> Specify an extension to the filename, (e.g. "_main") so the file location of targets becomes <file><ext>.<suffix> (default is ""). -W file-path=<dir> Specify additional path information for the target file (default is "") -W section=<string> String to use for a section reference when xref-sections=1 (default "Section"). -W sprintf=<string> Specify an sprintf string for formatting the output definitions (default is "%s"). -W xref-role-target[=<name>] Output cross-references for non-empty internal targets created from interpreted text roles (default is 0, or if specified with no name, 'target'). -W xref-sections=<0|1> Output cross-reference for section titles (default is 0). -W xref-targets=<0|1> Output cross-reference for internal targets (default is 1) =end Description =end reST