-
-
Notifications
You must be signed in to change notification settings - Fork 2.2k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
LaTeX: todo directive inserts \label
without a proper anchor point (from \phantomsection
or a counter stepping)
#8807
Labels
Milestone
Comments
jfbu
added a commit
to jfbu/sphinx
that referenced
this issue
Jan 31, 2021
Allow to link externally to some permanent PDF ids, like this http://example.com/doc.pdf#nameddest=my-target where my-target is chosen label in source (i.e. the document name is not added as prefix). This allows external linking in a way stable against renaming of sections or moving documentation from one document to the other in the same project. (The "nameddest=" part is even optional in some viewer) Closes: sphinx-doc#6276 Closes: sphinx-doc#8807
jfbu
added a commit
to jfbu/sphinx
that referenced
this issue
Feb 1, 2021
Allow to link externally to some permanent PDF ids, like this http://example.com/doc.pdf#nameddest=my-target where my-target is chosen label in source (i.e. the document name is not added as prefix). This allows external linking in a way stable against renaming of sections or moving documentation from one document to the other in the same project. (The "nameddest=" part is even optional in some viewer) Closes: sphinx-doc#6276 Closes: sphinx-doc#8807
jfbu
added a commit
to jfbu/sphinx
that referenced
this issue
Feb 1, 2021
Allow to link externally to some permanent PDF ids, like this http://example.com/doc.pdf#nameddest=my-target where my-target is chosen label in source (i.e. the document name is not added as prefix). This allows external linking in a way stable against renaming of sections or moving documentation from one document to the other in the same project. (The "nameddest=" part is even optional in some viewer) Closes: sphinx-doc#6276 Closes: sphinx-doc#8807
jfbu
added a commit
to jfbu/sphinx
that referenced
this issue
Feb 1, 2021
Allow to link externally to some permanent PDF ids, like this http://example.com/doc.pdf#nameddest=my-target where my-target is chosen label in source (i.e. the document name is not added as prefix). This allows external linking in a way stable against renaming of sections or moving documentation from one document to the other in the same project. (The "nameddest=" part is even optional in some viewer) Closes: sphinx-doc#6276 Closes: sphinx-doc#8807
jfbu
added a commit
to jfbu/sphinx
that referenced
this issue
Feb 1, 2021
Allow to link externally to some permanent PDF ids, like this http://example.com/doc.pdf#nameddest=my-target where my-target is chosen label in source (i.e. the document name is not added as prefix). This allows external linking in a way stable against renaming of sections or moving documentation from one document to the other in the same project. (The "nameddest=" part is even optional in some viewer) Closes: sphinx-doc#6276 Closes: sphinx-doc#8807
jfbu
added a commit
to jfbu/sphinx
that referenced
this issue
Feb 7, 2021
jfbu
added a commit
to jfbu/sphinx
that referenced
this issue
Feb 7, 2021
…unter" This reverts commit 16e3a93. Indeed this may have some after-effect. In current situation, todo directive issues latex `\label` but no reference anchor is set, so reference via LaTeX `\ref` will link probably to sectioning unit. With the reverted commit, the link will be to the notice/admonition but with some numbered label not appearing otherwise in document. Anyway, this issue is related to only small extend to the task of achieving permanent named destinations in PDF.
jfbu
added a commit
to jfbu/sphinx
that referenced
this issue
Feb 7, 2021
jfbu
added a commit
to jfbu/sphinx
that referenced
this issue
Feb 7, 2021
…unter" This reverts commit 16e3a93. Indeed this may have some after-effect. In current situation, todo directive issues latex `\label` but no reference anchor is set, so reference via LaTeX `\ref` will link probably to sectioning unit. With the reverted commit, the link will be to the notice/admonition but with some numbered label not appearing otherwise in document. Anyway, this issue is related to only small extend to the task of achieving permanent named destinations in PDF.
This was closed by #12508. |
jfbu
added a commit
to jfbu/sphinx
that referenced
this issue
Aug 19, 2024
jfbu
added a commit
that referenced
this issue
Aug 19, 2024
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
Describe the bug
Here is an example from
make latex
on our own docs, one sees in producedsphinx.tex
:However this environment, by default, does not insert an anchor point.
Now, normally this goes completely silent. If the document were to use
usage/quickstart:id5
destination name this would link to the section title which also has labelusage/quickstart:basic-configuration
.However I hit against this by working on implemeting the feature #6276.
As a work-around I will associate a counter to the
sphinxadmonition
environment so that it can be increased at each such occurrence and thus generate a suitable anchor point via hyperref services.This will be a fix to this.
To Reproduce
Steps to reproduce the behavior:
Use
todo
directive and check latex file frommake latex
.Environment info
The text was updated successfully, but these errors were encountered: