在斯芬克斯reST包含保密信息

Question

我在其自己的「copy.rst」文檔中有保密文本。我怎麼能把它包含在內，而不會出現在toctree中？

Answer 1

copy.rst到一個單獨的toctree添加與:hidden:選項：

.. toctree:: 

    doc1.rst 
    doc2.rst 

.. toctree:: 
    :hidden: 

    copy.rst 

你也可以什麼都不做（只是與其他.rst文件copy.rst保持），並簡單地忽略了「copy.rst ::警告：文檔不包含在任何toctree消息中。

Answer 2

正確的方法是

1. 不要在任何.. toctree:copy.rst。這樣這個頁面就不會出現在next/previous中。

2. 將:orphan:寫入copy.rst的第一行。這樣你就不會看到任何編譯器警告。