使用Sphinx处理第一个文件时，如何使rst_prolog中定义的替换在“`”引用的行中生效？

Question

我在conf.py中定义了一个替换：

rst_prolog = """
.. |tools| replace:: Something
"""

下面是第一个文件，替换在第1行有效，但对 |tools| 不起作用4/5/7等线路，如何让这些线路发生替换？

1   |tools| is a community project, guided by the `CHIPS Alliance`_ under the
2   `Linux Foundation`_.
   
3   We appreciate and welcome your contributions in whatever form; please see
4   `Contributing to |tools|
5   <https://github.com/|tools|/|tools|/blob/master/docs/CONTRIBUTING.rst>`_.
6   Thanks to our `Contributors and Sponsors
7   <https://|tools|.org/guide/latest/contributors.html>`_.
   
8   |tools| also supports and encourages commercial support models and
9   organizations; please see `|tools| Commercial Support
10   <https://|tools|.org/|tools|_commercial_support>`_.

如何对“`”中引用的这些行进行替换？

Answer 1

您发现了 reStructuredText 格式的限制： 不支持嵌套的 内联标记，rST 解析器不会在其他内联标记（如

|substitution-reference|

）中查找

*emphasized text*

或反引号中的解释文本。 （无论替换定义是在Sphinx“rst_prolog”中还是在rST源文件本身中都没有关系。）

对嵌套内联标记的支持是一个长期存在的 TODO 项目，不幸的是，进展甚微。