..  include:: /Includes.rst.txt
..  highlight:: rst

..  index:: pair: reST; Orphaned pages
..  _rest-orphans:

==============
Orphaned pages
==============


Usually it is desired to have each and every .rst- file appear in the
menu somewhere. Sphinx will issue a warning if this isn’t the case.

..  hint::

    If really needed, an .rst file may be tagged as :orphan: right at the beginning.
    This will suppress the warning.


..  code-block:: rst

    :orphan: