相关疑难解决方法(0)

Sphinx 文档中使用全局变量标准化链接

我正在使用 Sphinx 来记录工作项目。我想在整个文档的多个页面上使用指向下载的相同链接。

例如:home.rst:

Hi
==

I want you to download_ my project.

.. _download: blah.com/download
Run Code Online (Sandbox Code Playgroud)

other_page.rst

Hello Again
===========
You can also download_ it here.

.. _download: blah.com/download
Run Code Online (Sandbox Code Playgroud)

有没有某种方法可以让每个页面都指向一个变量,以便当链接需要更新时仅需要更新变量?

restructuredtext python-sphinx

4
推荐指数
1
解决办法
1796
查看次数

我可以使用 Sphinx 将所有外部链接保存在单独的文件中吗?

我有一个 Sphinx 项目,其中包含一组文件,其中每个文件底部包含外部链接作为引用,如下所示:

Some text with `my link`_, more text
100 lines of text ...

.. _my link: http://example.com
Run Code Online (Sandbox Code Playgroud)

我想重新组织我的文件,拆分它们,合并它们并重新使用外部链接。为了使这更容易,我想将我的链接保存在一个单独的文件中,每个链接都有一个我可以在文本中引用的唯一 ID。有没有办法做到这一点?渲染的输出仍应创建外部链接,而不是像如何收集 Sphinx 中的所有外部链接?中建议的脚注。

hyperlink python-sphinx

4
推荐指数
1
解决办法
552
查看次数