重用文本RST的獅身人面像文檔

Question

我在RST格式編寫文檔，並使用獅身人面像生成HTML。

我希望能夠在RST文件中編寫段落，並在同一文件夾中的不同RST文件中重複使用同一段落。我想要重複使用，如果我在原始段落中進行更改，它應該在我使用Sphinx生成HTML時引用的所有其他文件中自動更改。

是否有任何RST語法來做到這一點？任何幫助表示讚賞。

Answer 1

可以使用include directive。

對於基本包括引用您想重用如下段落：

Some text 

.. include:: /path/to/file_to_include.rst 

More text 

在我們的例子中，file_to_include.rst內容Included text。 斯芬克斯將生成：

Some text 

Included text 

More text 

正如可以在docutils的文檔（上面鏈接）中看到的，可以選擇指定的一組的選項，例如，以限制附帶的文本的行範圍的。