Включение информации о конфиденциальности в Sphinx reST - PullRequest
2 голосов
/ 18 ноября 2011

У меня есть текст конфиденциальности в его собственном документе "copy.rst". Как я могу включить это, не показывая это в toctree?

Ответы [ 2 ]

3 голосов
/ 22 ноября 2011

Правильный путь будет

  1. Не включайте copy.rst ни в какие .. toctree:. Таким образом, эта страница не будет отображаться в следующем / предыдущем.

  2. Запись :orphan: в первую строку copy.rst. Таким образом, вы не увидите никаких предупреждений компилятора.

1 голос
/ 18 ноября 2011

Добавьте copy.rst в отдельное дерево с параметром :hidden::

.. toctree::

   doc1.rst 
   doc2.rst

.. toctree::
   :hidden:

   copy.rst   

Вы также ничего не можете сделать (просто сохраните copy.rst с другими файлами .rst) и просто проигнорируете сообщение «copy.rst :: WARNING: документ не включен ни в одно дерево».

...