Mailman 3 September 2018 - Doc-SIG

About smart-quotes in translations
by Adrian Liaw Nov. 5, 2018

Nov. 5, 2018

Hi, Recently the zh-tw translations ran into a smart-quotes problem that I believe experienced by the Japanese team as well [1]. We're experiencing a similar problem [2], but here in our generated html the quotes not only are transformed into Chinese quotes automatically, but are also mismatching [3] where they should be pairs of 「 and 」. I also found out that the problem was fixed in GH-4006 [4] for Japanese translations, I suggest that we should have the same fix for zh-tw, perhaps zh-cn team would also want to do the same thing. [1] https://github.com/python/docsbuild-scripts/issues/32 [2] https://github.com/python/python-docs-zh-tw/pull/17#issuecomment-413134563 [3] https://python-doc-tw.github.io/tutorial/venv.html#managing-packages-with-p… , see the sentence "pip 有好幾個子指令：」search」、」install」、」uninstall」、」freeze」等等。（這可以參考安裝 Python 模組說明書來取得 pip 的完整文件說明。）" [4] https://github.com/python/cpython/pull/4006 Best Regards, Adrian Liaw -- Wey-Han "Adrian" Liaw (@adrianliaw2000) https://linkedin.com/in/adrianliaw https://github.com/adrianliaw

3 7

PSF Translations Working Group
by Julien Palard Sept. 19, 2018

Sept. 19, 2018

Greetings! We're collecting names for those interested in contributing and/or staying up to date with the PSF translations working group. You can see the Working Group charter started at https://wiki.python.org/psf/TranslationWG/Charter (thanks Naomi!). https://goo.gl/forms/I5oQ1Eqwq5SoJMnS2 Bests, -- Julien Palard https://mdk.fr

2 1

Migrating translations to 3.7
by Julien Palard Sept. 8, 2018

Sept. 8, 2018

Hi, We (France) migrated our translations to 3.7, if one want to follow here are the steps we used, here they are: - We "tx pull"ed transifex first. - We created the 3.7 git branch based on the 3.6 git branch - Used our "make merge" [1] to pull upstream pot files to our 3.7 branch (basically `sphinx-build -Q -b gettext` + `msgmerge`). - Configured 3.7 as a default branch on github - Changed the symlink 3 → 3.6 to 3 → 3.7 on docs.iad1.psf.io, so the viewers of docs.python.org/fr/3/ see 3.7 instead of 3.6.6 - Invalidated manually https://docs.python.org/fr/3/_static/documentation_options.js and https://docs.python.org/fr/3/ from fastly so the page and the version switcher display "3.7". The last two steps I can do them for you, (and yes we should automate them in docsbuild-scripts) don't hesitate to ask me to do them, by email or via IRC (I'm mdk on #python-doc on freenode). We're fixing fuzzy strings, and will wait for the ja team to update transifex projects so we can "tx push" on it (almost no french are working on tx, we're all working on github). -- Julien Palard https://mdk.fr

3 6

Typo in the Python tutorial
by Pablo Rodríguez Caballero Sept. 4, 2018

Sept. 4, 2018

Hello, there is a typo in the Python Tutorial in section 7.1.1: https://docs.python.org/3/tutorial/inputoutput.html#formatted-string-litera… The following line: >>> print('My hovercraft is full of {animals !r}.') Should be: >>> print(f'My hovercraft is full of {animals !r}.') Note the missing "f". Thank you for listening. Kind regards, Pablo Rodríguez Caballero.

1 0