=======================================
Python
=======================================
.. image:: https://badgen.net/badge/chat/on%20Discord/blue
:target: https://discord.gg/44XheGXhWH
:alt: Join Chat on Discord
Python 3.12 zh_TW
\ ` License`_\ ``_
https://python.github.io/python-docs-zh-tw/
Discord `discord.gg/44XheGXhWH`_
.. _discord.gg/44XheGXhWH: https://discord.gg/44XheGXhWH
.. contents:: ** Table of Contents**
License
==============
Documentation Contribution Agreement\
Documentation Contribution Agreement
------------------------------------
NOTE REGARDING THE LICENSE FOR TRANSLATIONS: Python's documentation is
maintained using a global network of volunteers. By posting this
project on Transifex, GitHub, and other public places, and inviting
you to participate, we are proposing an agreement that you will
provide your improvements to Python's documentation or the translation
of Python's documentation for the PSF's use under the CC0 license
(available at
https://creativecommons.org/publicdomain/zero/1.0/legalcode). In
return, you may publicly claim credit for the portion of the
translation you contributed and if your translation is accepted by the
PSF, you may (but are not required to) submit a patch including an
appropriate annotation in the Misc/ACKS or TRANSLATORS file. Although
nothing in this Documentation Contribution Agreement obligates the PSF
to incorporate your textual contribution, your participation in the
Python community is welcomed and appreciated.
You signify acceptance of this agreement by submitting your work to
the PSF for inclusion in the documentation.
~~~~~~~~
Python \
TransifexGitHub \
Python Python CC0\
https://creativecommons.org/publicdomain/zero/1.0/legalcode\
PSF PSF
Misc/ACKS TRANSLATORS
PSF \
Python
PSF
========
po (Portable Object)
-----------------------------
``.po`` po (*msgid*)\
(*msgstr*) ``#, fuzzy``
------------
****: ``make`` Unix \
`GitHub Codespace `_ ``make``
~~~~~~~~~~
- `GitHub `_
- ` git `_\ Windows
https://gitforwindows.org/
- ``.po`` `Poedit `_ po
- macOS `homebrew `_ gettext Sphinx
.. code-block:: bash
brew install gettext
brew link gettext --force
- pre-commit commit ``.po``
.. code-block:: bash
pip install pre-commit
pre-commit install
GitHub fork ``Fork``
GitHub fork
clone )
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
terminal
.. code-block:: bash
# git clone fork
git clone git@github.com:/python-docs-zh-tw.git
# clone
cd python-docs-zh-tw/
# python/python-docs-zh-tw upstream remote
git remote add upstream https://github.com/python/python-docs-zh-tw.git
~~~~~~~~~~~~
`GitHub Flow`_
.. _GitHub Flow: https://guides.github.com/introduction/flow/
` issue `_\
tutorial/introduction.po `make todo`
terminal
1. ``upstream/3.12`` branch Glossary \
branch ``glossary`` ::
git fetch upstream
git checkout -b glossary upstream/3.12
2. ``_ Poedit Poedit \
glossary ::
poedit glossary.po
3. rST ::
VERSION=3.12 make all
``_ clone CPython clone CPython\
Sphinx rST warning \
warning \
``_
4. CPython clone ``_ \
``Doc/build/html`` ``python3 -m http.server`` \
\
glossary ::
open ../cpython/Doc/build/html/glossary.html
5. commit commit message ::
git add glossary.po
git commit -m "Working on glossary."
6. push GitHub clone ``origin HEAD``
git push originbranch branch ::
git push origin HEAD
7. pull request
https://github.com/python/python-docs-zh-twCompare & Pull
Request pull request
8. GitHub review pull request\
branch branch ::
git checkout glossary
commitpush ::
git add glossary.po
git commit -m "glossary: small fixes"
git push origin HEAD
- upstream GitHub repo fetch
- origin fork push
- ``3.12`` branch branch \
--------------
(*msgstr*) ``#, fuzzy``
*fuzzy entries*\
` fuzzy entries`_
**Tutorial** ``tutorial/``
po
========
#.
#.
Python is supported by Python Software Foundation (PSF).
#.
CPU CPU
#. ` Glossary`_
#.
CPUUnicode
#. \
(regular expression)
Network News Transfer ProtocolPortable Network Graphics
#. reStructuredText
#. po 79 Poedit `poindent
`_
#. Python \
Glossary
``int````float````str````bytes````list````tuple``
``dict````set````iterator````generator````iterable``
``pickle``
----------
\
- list Python
- ``zip(*[iter(x)]*n)`` Python
- (HTML)
rST
----------------
- ``:xxx:`...``` rST
- rST :literal:`\\\ \ `
.. code-block:: rst
For more information, please see :ref:`detail-instruction`.
.. code-block:: rst
\ :ref:`detail-instruction`\
-
.. code-block:: rst
`Documentation bugs`_ on the Python issue tracker
.. code-block:: rst
Python issue tracker \ ` `_
Python issue tracker \ ` `_\
- ``::`` \ `
`_\
\ ****
``::`` ****
.. code-block:: rst
Here is a code example::
import sys
print(sys.version)
po po
.. code-block:: rst
Here is a code example::
.. code-block:: rst
::
\ ****
Glossary
===============
`
`_ \
`Discussion \
`_ \
Sprint
==============
Issue_\
Discord_
.. _Issue: https://github.com/python/python-docs-zh-tw/issues
.. _Discord: https://discord.gg/44XheGXhWH
coordinator `mattwang44 `_ \
`josix `_ email \
``mattwang44 at gmail dot com``, ``josixwang at gmail dot com``
============
- Discord channel `discord.gg/44XheGXhWH`_
- `Doc-SIG mailing list `_
- `PEP 545 `_
- `zh_CN Translation of the Python Documentation
`_
- `Cambridge Dictionary `_
==========
``python-docs-zh-tw`` clone \
CPython clone
::
~/
python-docs-zh-tw/
cpython/
clone CPython
.. code-block:: bash
$ git clone --depth 1 --no-single-branch https://github.com/python/cpython.git
commit
branch clone
CPython pot ( GitHub Actions )
----------------------------------------------------------
pot (*msgid*) (*msgstr*)\
CPython pot po po \
pot ``msgid`` ``#, fuzzy``
.. code-block:: bash
$ make merge
fuzzy entries
---------------------------------
po ``#, fuzzy`` fuzzy entry\
Linux ``#, fuzzy`` \
(*msgstr*) *Fuzzy entries*
.. code-block:: bash
$ make fuzzy
Project History
===============
This translation project was created by Liang-Bo Wang in late-2015, the
translations were hosted on https://docs.python.org.tw/3, and the project
includes daily auto-build sever, documentation website enhancement for
translations and project management on the `python-doc-tw
`_ GitHub organisation. The translations
were done on Transifex, with `our own translation team and project
`_. People who've contributed
on this Transifex project are listed in `TRANSLATORS`_
.. _TRANSLATORS: TRANSLATORS
In mid-2018, thanks to `PEP 545 `_
and the Doc-SIG community, this project has migrated to Python's Github
organisation and will become the official Taiwanese Mandarin translation of the
documentation.
Acknowledgement
===============
This translation project is highly influenced by python-doc-ja_ and
python-doc-fr_'s translation architecture and workflow (i.e. a shameless
copy). We truly appreciate their contributions.
.. _python-doc-ja: https://github.com/python-doc-ja/python-doc-ja
.. _python-doc-fr: https://github.com/python/python-docs-fr