OK I tested it and it seems to work great. Note that reference names are converted to kebab-case, for example the reference:
FOO_bar Is converted to the anchor: foo-bar On Friday, March 8, 2019 at 11:52:50 PM UTC+7, Rex East wrote: > > OK thanks, I will try that! > > On Thursday, March 7, 2019 at 2:03:50 AM UTC+9, Stefano David wrote: >> >> >> >> On Wednesday, 6 March 2019 15:55:58 UTC+1, Rex East wrote: >>> >>> Hi, I have a Sphinx project hosted on readthedocs.org. I want a way to >>> link from outside websites to a particular section in my documentation. And >>> I need it to be stable -- currently the URLs to sections look like this: >>> >>> >>> https://mysite.readthedocs.io/en/latest/models.html#built-in-fields-and-methods >>> >>> >>> But that URL is generated from the text of the section header, "Built-in >>> fields and methods". The link will break if I edit the section heading or >>> move that section to a different file in the documentation (not models.rst). >>> >>> Inside the project, I can use cross-references like: >>> >>> .. _FOO: >>> >>> and then >>> >>> :ref:`FOO` >>> >>> Which is great, but I cannot find a way to put these cross-references in >>> URLs. Any suggestions? >>> >> >> Assuming that the .. _FOO: label is in file models.rst, which in HTML >> becomes models.html, you can always reference is from the outside using >> https://mysite.readthedocs.io/en/latest/models.html#FOO, because any >> label will become an id="" in the HTML. If a particular section of the >> documentation is so important, add to it a label. >> >> In the case you move the content to another file, then my only idea is to >> keep the .. _FOO: label also in models.rst and eihter: 1) instead of the >> old content write something like "moved to new section" with a link or 2) >> add a javascript to models.html only, to (silently) redirect to the correct >> page. >> >> HTH, >> Stefano >> > -- You received this message because you are subscribed to the Google Groups "sphinx-users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at https://groups.google.com/group/sphinx-users. For more options, visit https://groups.google.com/d/optout.
