在Sphinx reST中包含保密信息

Question

我在自己的“copy.rst”文档中有保密文本。如果没有出现在toctree中我怎么能包括它呢？

Answer 1

正确的方法是

1. 请勿在{{1​​}}中添加copy.rst。这样，此页面不会出现在下一个/上一个页面。

2. 将.. toctree:写入:orphan:的第一行。这样您就不会看到任何编译器警告。

Answer 2

使用:hidden:选项将copy.rst添加到单独的toctree：

.. toctree::

   doc1.rst 
   doc2.rst

.. toctree::
   :hidden:

   copy.rst   

你也可以什么都不做（只需将copy.rst与其他.rst文件保持一致）并简单地忽略“copy.rst :: WARNING：文档不包含在任何toctree中”消息。