Need documentation for link markup with i18n

Takayuki Shimizukawa avatarTakayuki Shimizukawa created an issue

Link markup with i18n strategy recommendation should be added somewhere in the sphinx documentation.

https://groups.google.com/d/msg/sphinx-dev/uLjb0B-J5r0/PY_9MKt6gG8J

>   Here's how you can `download Django`_.
>
>   .. _download Django: https://www.djangoproject.com/download/
>
> When translating, this is suboptimal, because if you translate "download
> Django" in the paragraph, the link is lost. So:
> 1. Is there a recommended practice about how to include i18n-friendly links
> in sphinx docs?

1a. Sphinx-1.2b1 already solved this problem.
However, if the two links with `title string`_ style are included in one sentence,
you can not change the order of the links in the translation.

1b. `download Django <link-target-url>`_ style link always work
(include Sphinx-1.1.x).

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.