diff --git a/conf.py b/conf.py index df5805f84..6de594b23 100644 --- a/conf.py +++ b/conf.py @@ -177,7 +177,8 @@ # mapping unique short aliases to a base URL and a prefix. # https://www.sphinx-doc.org/en/master/usage/extensions/extlinks.html extlinks = { - "github": ("https://github.com/%s/", "%s"), + "github": ("https://github.com/%s", "%s"), + "github-user": ("https://github.com/%s", "@%s"), "pypi": ("https://pypi.org/project/%s/", "%s"), } diff --git a/documentation/translating.rst b/documentation/translating.rst index 8abb69fbb..9d21bca0e 100644 --- a/documentation/translating.rst +++ b/documentation/translating.rst @@ -12,140 +12,94 @@ They are built by `docsbuild-scripts docs.python.org. There are several documentation translations already in production; others are works in progress. -+-----------------+-------------------------------+----------------------------+ -| Language | Contact | Links | -+=================+===============================+============================+ -| Arabic (ar) | `Abdur-Rahmaan Janhangeer | `GitHub `_ | -| | `_ | | -+-----------------+-------------------------------+----------------------------+ -| Bengali as | `Kushal Das `_ | `GitHub `_ | -| spoken in | | | -| India (bn_IN) | | | -+-----------------+-------------------------------+----------------------------+ -| French (fr) | `Julien Palard (@JulienPalard)| `GitHub `_ | -| | `_ | | -+-----------------+-------------------------------+----------------------------+ -| Greek (gr) | `Lysandros Nikolaou | `GitHub `_ | -| | (@lysnikolaou) | | -| | `_, | | -| | `Fanis Petkos (@thepetk) | | -| | `_ | | -+-----------------+-------------------------------+----------------------------+ -| Hindi as spoken | | `GitHub `_ | -| in India (hi_IN)| | | -+-----------------+-------------------------------+----------------------------+ -| Hungarian (hu) | `Tamás Bajusz (@gbtami) | `GitHub `_ | -| | `_ | `Mailing List `_ | -+-----------------+-------------------------------+----------------------------+ -| Indonesian (id) | `Oon Arfiandwi `_ | `GitHub `_ | -+-----------------+-------------------------------+----------------------------+ -| Italian (it) | | `mail `_ | -+-----------------+-------------------------------+----------------------------+ -| Japanese (ja) | `Kinebuchi Tomohiko | `GitHub `_ | -| | (@cocoatomo) | `Doc `_ | -| | `_, | | -| | `Atsuo Ishimoto | | -| | (@atsuoishimoto) | | -| | `_ | | -+-----------------+-------------------------------+----------------------------+ -| Korean (ko) | | `GitHub `_ | -| | | `Doc `_ | -+-----------------+-------------------------------+----------------------------+ -| Marathi (mr) | `Sanket Garade | `GitHub `_ | -| | `_ | | -+-----------------+-------------------------------+----------------------------+ -| Lithuanian (lt) | | `mail `_ | -+-----------------+-------------------------------+----------------------------+ -| Persian (fa) | `Komeil Parseh (@mmdbalkhi) | `GitHub `_ | -| | `_ | | -+-----------------+-------------------------------+----------------------------+ -| Polish (pl) | `Maciej Olko (@m-aciek) | `GitHub `_ | -| | `_ | `Translations `_ | -| | | `Doc `_ | -| | | `mail `_ | -+-----------------+-------------------------------+----------------------------+ -| Portuguese (pt) | Gustavo Toffo | | -+-----------------+-------------------------------+----------------------------+ -| Portuguese | Marco Rougeth | `GitHub `_ | -| as spoken | | `Wiki `_ | -| in Brasil | | `Telegram `_ | -| (pt-br) | | `article `_| -+-----------------+-------------------------------+----------------------------+ -| Russian (ru) | | `GitHub `_ | -| | | `mail `_ | -+-----------------+-------------------------------+----------------------------+ -| Simplified | `Shengjing Zhu `_, | `Transifex `_ | -| Chinese | `Du, Meng `_ | `GitHub `_ | -| (zh-cn) | | `Doc `_ | -+-----------------+-------------------------------+----------------------------+ -| Spanish (es) | Raúl Cumplido | `GitHub `_ | -+-----------------+-------------------------------+----------------------------+ -| Traditional | `王威翔 Matt Wang | `GitHub `_ | -| Chinese | `_, | `Doc `_ | -| (zh-tw) | Josix Wang | | -+-----------------+-------------------------------+----------------------------+ -| Turkish (tr) | `Ege Akman (@egeakman) | `GitHub `_ | -| | `_ | `RTD `_ | -| | | `Doc `_ | -+-----------------+-------------------------------+----------------------------+ -| Ukrainian (uk) | `Dmytro Kazanzhy (@kazanzhy) | `GitHub `_ | -| | `_ | `Translations `_ | -+-----------------+-------------------------------+----------------------------+ - -.. _article_pt_br: https://rgth.co/blog/python-ptbr-cenario-atual/ -.. _gh_cocoatomo: https://github.com/cocoatomo -.. _gh_atsuoishimoto: https://github.com/atsuoishimoto -.. _gh_gbtami: https://github.com/gbtami -.. _gh_kushal: https://github.com/Kushal997-das -.. _gh_maciek: https://github.com/m-aciek -.. _gh_mdk: https://github.com/JulienPalard -.. _gh_mmdbalkhi: https://github.com/mmdbalkhi -.. _gh_oonid: https://github.com/oonid -.. _gh_osdotsystem: https://github.com/Abdur-rahmaanJ -.. _gh_zhsj: https://github.com/zhsj -.. _gh_dumeng: https://github.com/dumeng -.. _gh_mattwang44: https://github.com/mattwang44 -.. _gh_egeakman: https://github.com/egeakman -.. _gh_lysnikolaou: https://github.com/lysnikolaou -.. _gh_thepetk: https://github.com/thepetk -.. _email_garade: mailto:garade@pm.me -.. _email_kazanzhy: mailto:dkazanzhy@gmail.com -.. _chat_pt_br: https://t.me/pybr_i18n -.. _doc_ja: https://docs.python.org/ja/ -.. _doc_ko: https://docs.python.org/ko/ -.. _doc_pl: https://docs.python.org/pl/ -.. _doc_tr: https://docs.python.org/tr/ -.. _doc_zh_cn: https://docs.python.org/zh-cn/ -.. _doc_zh_tw: https://docs.python.org/zh-tw/ -.. _github_ar: https://github.com/Abdur-rahmaanJ/python-docs-ar -.. _github_bn_in: https://github.com/python/python-docs-bn-in -.. _github_es: https://github.com/python/python-docs-es -.. _github_fa: https://github.com/mmdbalkhi/python-docs-fa -.. _github_fr: https://github.com/python/python-docs-fr -.. _github_hi_in: https://github.com/CuriousLearner/python-docs-hi-in -.. _github_hu: https://github.com/python/python-docs-hu -.. _github_id: https://github.com/python/python-docs-id -.. _github_ja: https://github.com/python/python-docs-ja -.. _github_ko: https://github.com/python/python-docs-ko -.. _github_mr: https://github.com/sanketgarade/python-doc-mr -.. _github_pl: https://github.com/python/python-docs-pl -.. _github_pt_br: https://github.com/python/python-docs-pt-br -.. _github_tr: https://github.com/python/python-docs-tr -.. _github_uk: https://github.com/python/python-docs-uk -.. _github_zh_cn: https://github.com/python/python-docs-zh-cn -.. _github_zh_tw: https://github.com/python/python-docs-zh-tw -.. _github_ru: https://github.com/MLGRussianXP/python-docs-ru -.. _github_gr: https://github.com/pygreece/python-docs-gr -.. _list_hu: https://mail.python.org/pipermail/python-hu -.. _mail_it: https://mail.python.org/pipermail/doc-sig/2019-April/004114.html -.. _mail_lt: https://mail.python.org/pipermail/doc-sig/2019-July/004138.html -.. _mail_pl: https://mail.python.org/pipermail/doc-sig/2019-April/004106.html -.. _mail_ru: https://mail.python.org/pipermail/doc-sig/2019-May/004131.html -.. _rtd_tr: https://python-docs-tr.readthedocs.io/ -.. _tx_pl: https://explore.transifex.com/python-doc/python-newest/ -.. _tx_uk: https://explore.transifex.com/python-doc/python-newest/ -.. _tx_zh_cn: https://explore.transifex.com/python-doc/python-newest/ -.. _wiki_pt_br: https://python.org.br/traducao/ +.. list-table:: + :header-rows: 1 + + * - Language + - Contact + - Links + * - Arabic (ar) + - Abdur-Rahmaan Janhangeer (:github-user:`Abdur-rahmaanJ`) + - :github:`GitHub ` + * - Bengali as spoken in India (bn_IN) + - Kushal Das (:github-user:`Kushal997-das`) + - :github:`GitHub ` + * - `French (fr) `__ + - Julien Palard (:github-user:`JulienPalard`) + - :github:`GitHub ` + * - Greek (gr) + - Lysandros Nikolaou (:github-user:`lysnikolaou`), + Fanis Petkos (:github-user:`thepetk`) + - :github:`GitHub ` + * - Hindi as spoken in India (hi_IN) + - Sanyam Khurana (:github-user:`CuriousLearner`) + - :github:`GitHub ` + * - Hungarian (hu) + - Tamás Bajusz (:github-user:`gbtami`) + - :github:`GitHub `, + `mailing list `__ + * - `Indonesian (id) `__ + - Oon Arfiandwi (:github-user:`oonid`) + - :github:`GitHub ` + * - Italian (it) + - Alessandro Cucci (`email `__) + - `Original mail `__ + * - `Japanese (ja) `__ + - Kinebuchi Tomohiko (:github-user:`cocoatomo`), + Atsuo Ishimoto (:github-user:`atsuoishimoto`) + - :github:`GitHub ` + * - `Korean (ko) `__ + - 오동권 (:github-user:`flowdas`) + - :github:`GitHub ` + * - Marathi (mr) + - Sanket Garade (:github-user:`sanketgarade`, `email `__) + - :github:`GitHub ` + * - Lithuanian (lt) + - Albertas Gimbutas (:github-user:`albertas`, `email `__) + - `Original mail `__ + * - Persian (fa) + - Komeil Parseh (:github-user:`mmdbalkhi`) + - :github:`GitHub ` + * - `Polish (pl) `__ + - Maciej Olko (:github-user:`m-aciek`) + - :github:`GitHub `, + `Transifex `_, + `original mail `__ + * - Portuguese (pt) + - Gustavo Toffo + - + * - `Portuguese as spoken in Brasil (pt-br) `__ + - Marco Rougeth + - :github:`GitHub `, + `wiki `__, + `Telegram `__, + `article `__ + * - Russian (ru) + - Daniil Kolesnikov (:github-user:`MLGRussianXP`, `email `__) + - :github:`GitHub `, + `mail `__ + * - `Simplified Chinese (zh-cn) `__ + - Shengjing Zhu (:github-user:`zhsj`), + Du, Meng (:github-user:`dumeng`) + - :github:`GitHub `, + `Transifex `_ + * - `Spanish (es) `__ + - Raúl Cumplido + - :github:`GitHub ` + * - `Traditional Chinese (zh-tw) `__ + - 王威翔 Matt Wang (:github-user:`mattwang44`), + Josix Wang + - :github:`GitHub ` + * - `Turkish (tr) `__ + - Ege Akman (:github-user:`egeakman`) + - :github:`GitHub `, + `RTD `__ + * - `Ukrainian (uk) `__ + - Dmytro Kazanzhy (:github-user:`kazanzhy`, `email `__) + - :github:`GitHub `, + `Transifex `_ + +.. _tx: https://explore.transifex.com/python-doc/python-newest/ Starting a new translation ==========================