在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.