id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
25077	Named links in the documentation it is impossible to translate into other languages.	Grigoriy Kramarenko	nobody	"For Russian-speaking users, [http://djbook.ru/rel1.8/ there is a translation of the Django documentation]. Working on it for a few people. Periodically translations are synchronize with upstream. And there is one, but the '''big problem''' with the translation links in the documentation. 

Example:

{{{
Although you can use Django without a database, it comes with an
`object-relational mapper`_ in which you describe your database layout in Python
code.

.. _object-relational mapper: http://en.wikipedia.org/wiki/Object-relational_mapping
}}}

If translate text link `object-relational mapper`  in the paragraph, then in some versions of shpinx such links are crumbling.

Safer work anonymous links (In the file `intro/contributing.txt` it's done that way):

{{{
Although you can use Django without a database, it comes with an
`object-relational mapper`__ in which you describe your database layout in Python
code.

__ http://en.wikipedia.org/wiki/Object-relational_mapping
}}}

It certainly does not concern `slug links`, such as:

{{{
`link-to-other-page`_ and `translated link to page <link-to-page-2>`_
}}}


Might be worth globally in all of the original documentation named links to replace to anonymous?

Thanks."	Uncategorized	closed	Documentation	1.8	Normal	invalid			Unreviewed	0	0	0	0	0	0