You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
NOTE: This doc is out of date and needs rework! The `pull request \#13 <https://github.com/python-docs-translations/transifex-automations/pull/13>`_ is a work in progress that would change some instructions from this guide.
5
+
NOTE: This doc is out of date and needs rework! The
is a work in progress that would change some instructions from this guide.
6
8
7
-
This document aims to list the steps required for updating version of the 'Python' project (slug 'python-newest) in python-doc organization in Transifex.
9
+
This document aims to list the steps required for updating version of the 'Python'
10
+
project (slug 'python-newest) in python-doc organization in Transifex.
8
11
9
12
1. Back up current translations:
10
13
11
14
#. Run ``sh scripts/update.sh`` to set up the environment, if not done already;
12
15
#. Run ``python3 scripts/getlangs.py`` to get a list of all languages;
13
16
#. Change to ``cpython/Doc/locales`` directory; and
14
-
#. Run ``tx pull --languages <LANGUAGES>`` to download translations from Transifex, replacing ``<LANGUAGES>`` with the output of step 1.2.
17
+
#. Run ``tx pull --languages <LANGUAGES>`` to download translations from Transifex,
18
+
replacing ``<LANGUAGES>`` with the output of step 1.2.
15
19
16
20
2. Post a Python version upgrade announcement
17
21
18
22
3. (How?) Lock all resources in python-newest for all languages
19
23
20
24
#. Take note of the last change in timeline and its timestamp: *Python* > *Settings* > *Timeline*.
21
25
22
-
4. Create a Transifex project with versioned name to receive python-newest's translations, setting it with the following values:
26
+
4. Create a Transifex project with versioned name to receive python-newest's
27
+
translations, setting it with the following values:
23
28
24
29
:*Name your project*: Python <version> (e.g. Python 3.10)
25
30
:*URL to opensource license*: https://github.com/python/cpython
@@ -38,19 +43,25 @@ In *General* tab:
38
43
39
44
In *Workflow* tab, enable the *Translation Memory Fillup* option by checking the checkbox;
40
45
41
-
NOTE: The *Translation Memory Fillup* option is essential to have a translation in one of the version projects to be populated to this project. This drastically reduces translation effort replicating one contribution to other strings that are exactly the same.
46
+
NOTE: The *Translation Memory Fillup* option is essential to have a translation
47
+
in one of the version projects to be populated to this project. This drastically
48
+
reduces translation effort replicating one contribution to other strings that are
49
+
exactly the same.
42
50
43
51
6. Adjust the `CI workflow <https://github.com/python-docs-translations/transifex-automations/tree/main/.github/workflows>`_ with the new Python version:
44
52
45
53
#. Set ``PYTHON_NEWEST`` environment variable inside ``env`` to the new Python version
46
54
#. Edit ``cpython_version`` inside ``strategy.matrix`` adding the new version to the beginning array
47
55
48
-
7. Push source strings to python-newest by manually running the CI workflow: Actions_ tab > CI > Run workflow button > "Branch: main" and confirm "Run workflow"
56
+
7. Push source strings to python-newest by manually running the CI workflow:
57
+
Actions_ tab > CI > Run workflow button > "Branch: main" and confirm "Run workflow"
8. Unlock translations in python-newest, if locked
53
62
54
-
9. Double-check resources in python-newest. New resources are named after their pot files (e.g. "3.11.pot"), and they should be renamed to match their slug (e.g. "whatsnew--3_11")
63
+
9. Double-check resources in python-newest. New resources are named after their
64
+
pot files (e.g. "3.11.pot"), and they should be renamed to match their slug (e.g. "whatsnew--3_11")
55
65
56
-
10. Announce that the maintenance is over, and that python-newest is now using new Python version
66
+
10. Announce that the maintenance is over, and that python-newest is now using
0 commit comments