Сфинкс сноски на страницах или эквивалент - PullRequest
0 голосов
/ 28 сентября 2018

У меня есть документ с некоторыми сносками:

doc.rst

This sentence needs clarification\ [#fn1]_.

Если поместить сноску в тот же файл, она будет работать нормально.Однако мне бы хотелось иметь отдельный файл со сносками из нескольких разных документов:

Appendment.rst

[#fn1] A word of explanation.

Это дает мне два наборапредупреждения.Сначала предупреждение в supplement.rst:

...supplement.rst:1: WARNING: Footnote [#] is not referenced.

Затем пара предупреждений в doc.rst:

...doc.rst:1: WARNING: Too many autonumbered footnote references: only 0 corresponding footnotes available.
...doc.rst:1: WARNING: Unknown target name "fn1".

Ссылка в doc.html отображается как ссылка с текстом [#fn1]_, которая никуда не идет, а номер слева от примечания в supplement.html выделен серым цветом.

Как реализовать сноски кросс-документов в сфинксе?

1 Ответ

0 голосов
/ 28 сентября 2018

Область сносок ограничена только документом и не является глобальной для всего набора документов.Вы могли бы реализовать цитаты или глоссарий .

...