我发现.. include::指令对于文本重用非常有用:相同的部分可以插入到不同的文档中。
但是标题级别存在问题。
例如,如果我有part.rst二级标题
part.rst
Header level 2
----------------
My text to be included
Run Code Online (Sandbox Code Playgroud)
并将其包含在具有各种标题级别的不同文档中
doc 1
Header level 1
================
.. include:: part.rst
Run Code Online (Sandbox Code Playgroud)
doc2
Header level 2
----------------
.. include:: part.rst
Run Code Online (Sandbox Code Playgroud)
doc 3
Header level 3
~~~~~~~~~~~~~~~~~
.. include:: part.rst
Run Code Online (Sandbox Code Playgroud)
永远都是2级。控制不了。
我读过关于sphinx.ext.ifconfig – Include content based on configuration,我可以用
part.rst
.. ifconfig:: hide_part_rst_title
Header level 2
----------------
My text to be included
Run Code Online (Sandbox Code Playgroud)
但是看起来在许多零件文件的情况下创建了许多变量。
可能有更优雅的方式吗?
如何包含.rst没有原始标题的文件?如果我裁剪这个,我可以像这样在每个地方添加一个标题
.. doc 1
Header level 1
================ …Run Code Online (Sandbox Code Playgroud)