用重组后的文本+狮身人面像替换另一个文档中的字段属性

Question

我正在使用sphinx处理重组文本中的某些文档，并希望将定义为字段的值从一个文档替换为另一个文档。

给出文件foo.rst，我想在另一个文档中使用其Author字段的值。例如，其定义如下：

Foo
===

:Author: Random, Joe;

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do
eiusmod tempor incididunt ut labore et dolore magna aliqua ...

另外一些文件bar.rst中有以下代码段

In "Foo" <insert author field from foo.rst>
writes ...

使用sphinx编译并转换为HTML之后，我希望bar.rst的输出为：

In "Foo" Random, Joe writes ...

我看过的文档只有specifies setting fields，从其他文档访问这些字段没有任何帮助。

Answer 1

据我所知，尚无直接方法，可能取决于您使用的主题（请查看conf.py项目“ html_theme = ...”）。

但是您可以这样做：

在foo.rst中：

.. _author_random:

:Author: Random, Joe;

在bar.rst中：

:ref:`any text <author_random>`

然后，您在bar.html中具有指向_author_random的链接，其中包含文本“ any text”。