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

.. _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:: rest

   :orphan: