角色:doc:不尊重格式

时间:2018-07-25 22:23:07

标签: python-sphinx restructuredtext

在RsT中,可以使用:doc:角色创建对另一个文档的引用。 来自documentation

  

:doc:

     

链接到指定的文档;文件名称可以是   以绝对或相对方式指定。例如,如果   参考:doc:parrot出现在文档草图/索引中,然后   该链接指的是草图/鹦鹉。如果引用是:doc:{/people或:doc:../people,则链接指向人员。

     

如果未给出明确的链接文本(如往常::doc:Monty Python members </people>),则链接标题将为给定文档的标题。

但是,我注意到,如果文档标题具有任何格式(如粗体或斜体),则由:doc:角色呈现时将不予尊重。有没有办法来解决这个问题?

示例: 文件“ mydocument.rst”:

===================================
This is a *very* important document
===================================

在“ myotherdocument.rst”文件中:

Check :doc:mydocument for details.

“ myotherdocument”的输出将以纯文本形式显示标题:

Check This is very important document for details.

0 个答案:

没有答案