[Python-ideas] Cross link documentation translations

[Wes Turner]

ReadTheDocs supports hosting projects with multiple translations:

| Docs: http://docs.readthedocs.org/en/latest/localization.html

- [ ] There could be a dedicated Python Infrastructure ReadtheDocs Docker
instance.
https://github.com/rtfd/readthedocs-docker-images

ReadTheDocs CPython Docs
/en/latest/

* | Docs: http://cpython.readthedocs.org/en/latest/
* | Project: http://readthedocs.org/projects/cpython/

   * [ ] All past revisions
   * [ ] All translations

On Jan 24, 2016 4:41 AM, "Julien Palard" <julien at palard.fr> wrote:
>
> o/
>
> While translating the Python Documentation in French [1][2], I discovered
that we're not the only country doing it, there is also Japan [3][4], and
Spain [5]. It's possible there's other but I didn't find them (and it's the
problem).
>
> But there's only a few way for users to find the translations (hearing
about them, or explicitly searching for them on a search engine, which they
won't do, obviously expecting a link from the english version if they
exists).
>
> So here is my idea: Why not linking translations from the main
documentation?
>
> I know that's not directly supported by Sphinx doc [6], but separate
sphinx build, blindly (with hardcoded links) linking themselves, may work
(like readthedoc is probably doing). The downside of those links is that
we'll sometime link to untranslated parts, but those parts may be marked as
untranslated [7] to encourage new translators to help.
>
> Thoughts?
>
> [1] http://www.afpy.org/doc/python/3.5/
> [2] https://github.com/afpy/python_doc_fr
> [3] http://docs.python.jp/3/
> [4] https://github.com/python-doc-ja/python-doc-ja
> [5] http://docs.python.org.ar/tutorial/3/index.html
> [6] https://github.com/sphinx-doc/sphinx/issues/2252
> [7] https://github.com/sphinx-doc/sphinx/issues/1246
>
> --
> Julien Palard
> _______________________________________________
> Python-ideas mailing list
> Python-ideas at python.org
> https://mail.python.org/mailman/listinfo/python-ideas
> Code of Conduct: http://python.org/psf/codeofconduct/
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-ideas/attachments/20160124/d66248ac/attachment.html>