sphinx-doc / sphinx

The Sphinx documentation generator
https://www.sphinx-doc.org/
Other
6.23k stars 2.04k forks source link

Footnote backlinks do not work #1058

Closed shimizukawa closed 9 years ago

shimizukawa commented 9 years ago

Footnotes are not backlinked to their places of use as can be seen at http://docs.python.org/library/sys (search for [C99], the footnote is at the very bottom.)

I have not yet investigated in how far other builders are affected or which part of the code is defective. Current trunk seems to exhibit that defect as well.


shimizukawa commented 9 years ago

From Nozomu Kaneko on 2012-12-17 22:48:24+00:00

Technically speaking, it's a citation, not a footnote. (ref. http://sphinx-doc.org/rest.html#citations)

shimizukawa commented 9 years ago

From Nozomu Kaneko on 2012-12-18 21:31:19+00:00

fixed on https://bitbucket.org/birkenfeld/sphinx/pull-request/97

However, i18n part is still broken. I'll fix it later.

shimizukawa commented 9 years ago

From Nozomu Kaneko on 2012-12-19 08:58:54+00:00

duplicate issue: #972 Footnote back-reference not working for citations

shimizukawa commented 9 years ago

From Georg Brandl on 2012-12-30 17:14:56+00:00

Merged in knzm/sphinx-fix-backlink-fork (https://bitbucket.org/birkenfeld/sphinx/pull-request/97: fix #1058 Footnote backlinks do not work)

→ <<cset 2e59d4a2d9d70c867a4832d095900c227a5f3fc1>>

shimizukawa commented 9 years ago

From Georg Brandl on 2012-12-30 17:14:56+00:00

fix #1058: footnote backlinks with i18n

→ <>

shimizukawa commented 9 years ago

From Georg Brandl on 2012-12-30 17:14:56+00:00

fix #1058 Footnote backlinks do not work

→ <>

shimizukawa commented 9 years ago

From Takayuki Shimizukawa on 2013-06-07 00:26:34+00:00

Issue #972 was marked as a duplicate of this issue.

shimizukawa commented 9 years ago

From Georg Brandl on 2014-10-18 07:32:19+00:00

Removing version: 1.0.7 (automated comment)

eric-wieser commented 4 years ago

This seems to be broken again

tk0miya commented 4 years ago

In my eyes, it seems working fine. The [C99] hyperlink is available to me.

http://docs.python.org/library/sys (search for [C99], the footnote is at the very bottom.)

Please let me know what is happened (as a new issue).

eric-wieser commented 4 years ago

Apologies, I was mislead by a screenshot from another issue (in sphinx_rtd_theme), which suggested I should see number to the right of [C99], rather than C99 itself being the link.

tk0miya commented 4 years ago

The backref numbers will be shown if there are two or more citation references for the same citation definition.

eric-wieser commented 4 years ago

Indeed, that's what I worked out eventually. Sorry for the waste of time!