Инкрементные ссылки в RST - PullRequest
0 голосов
/ 14 июня 2019

У меня есть файл .rst, в котором я храню изменения моего проекта: https://raw.githubusercontent.com/giampaolo/psutil/master/HISTORY.rst

Я отмечаю каждый номер выпуска как number_ (например, 1512_) и внизу страницы ядобавьте гиперссылку как:

.. _1512: https://github.com/giampaolo/psutil/issues/

Это не поддерживается (файл становится слишком большим, номера выпусков растут в геометрической прогрессии).Есть ли способ автоматизировать это, чтобы избежать повторений?

1 Ответ

0 голосов
/ 25 июня 2019

Звучит так, как будто вам нужен пользовательский реструктурированный текст «роль интерпретируемого текста». Я упоминаю об этом не потому, что ожидаю, что вы будете знать, что это такое, а предоставьте некоторые ключевые слова для поиска, если этот ответ не приведет вас к цели.

Если вы используете Sphinx, то, вероятно, вы можете просто использовать включенное extlinks расширение

Другим вариантом может быть использование расширения issetracker .

Любой из них должен позволить вам написать что-то вроде (используя пример из файла, на который вы ссылаетесь выше):

- :issue:`1529`: [AIX] compilation error on AIX 7.2 due to 32 vs 64 bit differences.
  (patch by Arnon Yaari)

Если это не работает для вашего варианта использования, вы также можете написать свою собственную роль. По сути, это означает, что вы пишете свою собственную функцию Python и регистрируете ее с документами для получения желаемого результата. Там есть некоторая документация о том, как создавать свои собственные роли здесь

Вы также можете изменить другое подобное расширение, например, traclinks расширение ( здесь или здесь ).

...