Embedded alias doesn't work for hyperlink markup

Anonymous avatarAnonymous created an issue

The reStructuredText Markup Specification states

A hyperlink reference may directly embed a target URI or (since Docutils 0.11) a hyperlink reference within angle brackets ("<...>") as follows:

   See the `Python home page <http://www.python.org>`_ for info.

   This `link <Python home page_>`_ is an alias to the link above.

If you try this in Sphinx the second line will generate a link to "_build/html/Pythonhomepage_" instead of the Python home page. What I really want to do is define a target like

.. _target:

and then use it with some alternate text like

This is `the link <target_>`_ you want.

This documentation indicates that should be possible but I can't get it to work, nor the documentation example. I checked that I am running 1.1.3.

Comments (2)

  1. Log in to comment
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.