Hi Inada,

> But I can"t see language switcher on Python 3.6 document.

Yes I'm currently backporting it to older branches (3.6 and 2.7 at least).

> We (Japanese translators) translates latest stable release, not
> development branch.

> Is it possible to publish Japanese only for 3.6 branch?

Current implementation of the switcher can't do it, see: 
https://github.com/python/cpython/blob/dff9b5f9d62aa0b23f8a255867d09d11890efd1b/Doc/tools/static/switchers.js
 but if it make sense, it may be enhanced.
We're also limited by the fact that switchers are versionned in cpython itself, 
so they will follow the freez (security only) cycles, typically blocking us to 
add/remove a translations to a frozen versions, which may or may not be a 
problem as old versions documentation are built without switchers (see: 
https://docs.python.org/3.4/).
Last comment about this is that the current script building the documentation 
will automatically find the nearest branch for translations, see: 
https://github.com/python/docsbuild-scripts/blob/master/build_docs.py#L132
meaning that if you're working on the 3.6 branch, the ja/3.7 directory will be 
built using your 3.6 po files, which may (or may not) be desirable. Advantages 
are:
- If a translation team want to translate 3.7 only, then can and 3.6 will be 
partially build using it
- If a translation team is late adding a new branch, the new branch will still 
be built for them using their old translations, which for an unknown timespan 
will not diverge a lot
- Crawlers can start discovering / indexing new branches before translators 
start working on them
Disadvantages are more obvious: Translations are only partials.
So, currently, if you push a 3.6 branch to python-docs-ja, ja/{2.7,3.5,3.6,3.7} 
will be built using it.

--
Julien Palard
https://mdk.fr
_______________________________________________
Doc-SIG maillist  -  Doc-SIG@python.org
https://mail.python.org/mailman/listinfo/doc-sig

Reply via email to