如何使用Intersphinx 来link 文件时底层域会发生变化？
How to use Intersphinx to link documents when the underlying domain will change?
我有一个离线场景中重组文本文档的用例。安装后，它会从一个域移动到另一个域，并且通常无法访问 Internet。我假设 HTML 狮身人面像的输出。我有多个微服务项目，我希望能够使用 Intersphinx 在它们之间共享链接。这些项目将一起运行，浏览一个项目的人将可以访问其他项目。我希望它们总是可以安排在同一顶级域的项目文件夹中。
我在 Internet 上看到的所有示例似乎都假定将使用静态域并且不会将文档复制到新位置。有什么方法可以轻松应对不断变化的域？
另一个可能涵盖前一个问题的问题是相对链接。我们能否以不需要我重建文档的方式来解释域更改？在 HTML 中，我会链接到“/some/page.html”而不是“http://example.com/some/page.html”。
听起来您只是想使用相对路径而不是域名。如果是这种情况，您将在 conf.py:
中执行类似的操作
intersphinx_mapping = {
'other': ('example/', 'example/example.inv'),
}
Relative local paths for target locations are taken as relative to the base of the built documentation, while relative local paths for inventory locations are taken as relative to the source directory.
我有一个离线场景中重组文本文档的用例。安装后，它会从一个域移动到另一个域，并且通常无法访问 Internet。我假设 HTML 狮身人面像的输出。我有多个微服务项目，我希望能够使用 Intersphinx 在它们之间共享链接。这些项目将一起运行，浏览一个项目的人将可以访问其他项目。我希望它们总是可以安排在同一顶级域的项目文件夹中。
我在 Internet 上看到的所有示例似乎都假定将使用静态域并且不会将文档复制到新位置。有什么方法可以轻松应对不断变化的域？
另一个可能涵盖前一个问题的问题是相对链接。我们能否以不需要我重建文档的方式来解释域更改？在 HTML 中，我会链接到“/some/page.html”而不是“http://example.com/some/page.html”。
听起来您只是想使用相对路径而不是域名。如果是这种情况，您将在 conf.py:
中执行类似的操作intersphinx_mapping = {
'other': ('example/', 'example/example.inv'),
}
Relative local paths for target locations are taken as relative to the base of the built documentation, while relative local paths for inventory locations are taken as relative to the source directory.