Sphinx: URL для прямой ссылки на ярлык извне Sphinx

#python-sphinx

#python-sphinx

Вопрос:

У меня есть проект Sphinx с несколькими страницами, каждая из которых содержит несколько разделов. Я помечаю разделы так, например, в my_page.rst :

 .. _sec_foo:

Foo
~~~
  

Я могу ссылаться на эти разделы из моих документов Sphinx, например, с помощью

 :any:`sec_foo`
  

Я хотел бы иметь возможность предоставить ссылку из другого места в Интернете на мой раздел «Foo», который не зависит от знания того, что он находится в my_page.rst .

Я представляю что-то вродеhttps://myproject.org/en/latest/labels/sec_foo который перенаправляет на ссылку выше, но любое решение, которое позволяет мне переходить .. _sec_foo: с одной страницы на другую, не меняя мои ссылки в другом месте, является приемлемым.

Есть ли способ добиться этого, используя стандартную функциональность Sphinx? Если нет, с помощью плагина? Если нет, используйте некоторые функции Sphinx, чтобы сделать подход «сделай сам» (например, проанализировать исходный код, чтобы получить все пары ярлык / страница, сгенерировать страницы для всех URL-адресов с перенаправлениями) менее болезненным?

Комментарии:

1. Единственный вариант потребует, чтобы внешний сайт также использовал Sphinx. Таким вариантом будет плагин intersphinx .