相关疑难解决方法(0)

Python Sphinx 包含指令:忽略包含文件中的标头

我发现.. 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)

python restructuredtext python-sphinx

2
推荐指数
1
解决办法
1934
查看次数

标签 统计

python ×1

python-sphinx ×1

restructuredtext ×1