Add Greek translation (we think we're okay to add this to production since we've done 100% of the prerequisites. If someone could double-check that, it'd be great!
Because the iso639 tag for Greek isel, but the more common name isgr, we'd named the repositorypython-docs-gr. I've added the ability to have an alternative repository name. If people think that's a bad idea, we can always rename the repository as well.

Add Greek translation and allow for alternative repo name

b7d32e7

Copy link

Contributor

m-aciek commentedFeb 14, 2025•
edited
Loading

Because the iso639 tag for Greek is el, but the more common name is gr, we'd named the repository python-docs-gr. I've added the ability to have an alternative repository name. If people think that's a bad idea, we can always rename the repository as well.

If we keep the common name, would it be worth to mention allowing exceptions in the repository name in PEP 545?https://peps.python.org/pep-0545/#create-github-repository

Create a repository named “python-docs-{LANGUAGE_TAG}” (IETF language tag, without redundant region subtag, with a dash, and lowercased.) on the Python GitHub organization (SeeRepository For Po Files.), and grant the language coordinator push rights to this repository.

Maybe: ?

Create a repository named “python-docs-{LANGUAGE_TAG}” (without redundant region subtag, with a dash, and lowercased; IETF language tag is recommended) on the Python GitHub organization (SeeRepository For Po Files.), and grant the language coordinator push rights to this repository.

Copy link

Member

hugovk commentedFeb 14, 2025

Re:https://peps.python.org/pep-0545/#add-translation-to-the-language-switcher

As soon as the translation hits:
100% of bugs.html with proper links to the language repository issue tracker.

https://python-docs-gr.readthedocs.io/el/latest/bugs.html

Looks good.

100% of tutorial.

https://python-docs-gr.readthedocs.io/el/latest/tutorial/index.html

A spot check found a little bit of English inhttps://python-docs-gr.readthedocs.io/el/latest/tutorial/errors.html#handling-exceptions

100% of library/functions (builtins).

Looks good, except forabs:https://python-docs-gr.readthedocs.io/el/latest/library/functions.html#abs

the translation can be added to the language switcher.

Copy link

MemberAuthor

lysnikolaou commentedFeb 14, 2025

A spot check found a little bit of English inpython-docs-gr.readthedocs.io/el/latest/tutorial/errors.html#handling-exceptions

Hmm, that's odd. It looks like this is implemented inthe po file.

Looks good, except forabs:python-docs-gr.readthedocs.io/el/latest/library/functions.html#abs

Again, same thing. It looks like this is implemented inthe po file, but does not appear in the built docs.

Does anyone have an idea on why that might be?

Copy link

Contributor

m-aciek commentedFeb 14, 2025

@lysnikolaou most probably there's a slight change in the original sources, on 3.13 branch, it would be best to update the files with the latest sources version.

Copy link

skpanagiotis commentedFeb 14, 2025

Looks good, except for abs:python-docs-gr.readthedocs.io/el/latest/library/functions.html#abs

You can see this behavior also in Spanish versionhttps://docs.python.org/es/3.13/library/functions.html#abs

Copy link

Contributor

rffontenelle commentedFeb 14, 2025

You can see this behavior also in Spanish versionhttps://docs.python.org/es/3.13/library/functions.html#abs

Brazilian Portuguese looks OK, so it is probably just out-of-date source string.

Copy link

Contributor

m-aciek commentedFeb 14, 2025•
edited
Loading

If someone could double-check that, it'd be great!

Checking with the HEAD of 3.13, there seems to be some new content and some differences. Maybe the code snippets blocks affected the numbers 🤔

Doc % make venvDoc % make gettext   python-docs-gr % uv pip install git+https://git.afpy.org/maciek/potodo.git@fix-pot-clipython-docs-gr % potodo --pot ../cpython/Doc/build/gettext --show-finished…- bugs.po                         30 /  31 ( 96.0% translated).…# library (5.07% done)…- functions.po                   413 / 510 ( 80.0% translated).…# tutorial (69.95% done)- appendix.po                     20 /  28 ( 71.0% translated).- appetite.po                     17 /  17 (100.0% translated).- classes.po                     115 / 149 ( 77.0% translated).- controlflow.po                 155 / 223 ( 69.0% translated).- datastructures.po               82 / 125 ( 65.0% translated).- errors.po                       67 /  95 ( 70.0% translated).- floatingpoint.po                43 /  76 ( 56.0% translated).- index.po                         8 /   8 (100.0% translated).- inputoutput.po                  72 / 112 ( 64.0% translated).- interactive.po                   7 /   7 (100.0% translated).- interpreter.po                  25 /  33 ( 75.0% translated).- introduction.po                 76 / 119 ( 63.0% translated).- modules.po                      88 / 117 ( 75.0% translated).- stdlib.po                       47 /  67 ( 70.0% translated).- stdlib2.po                      41 /  65 ( 63.0% translated).- venv.po                         29 /  42 ( 69.0% translated).- whatnow.po                      18 /  18 (100.0% translated).…

For comparison locally looks like 100% indeed:

python-docs-gr % potodo --show-finished --no-cache…- bugs.po                         30 /  30 (100.0% translated).…- functions.po                   461 / 461 (100.0% translated).…# tutorial (100.00% done)- appendix.po                     20 /  20 (100.0% translated).- appetite.po                     17 /  17 (100.0% translated).- classes.po                     119 / 119 (100.0% translated).- controlflow.po                 164 / 164 (100.0% translated).- datastructures.po               90 /  90 (100.0% translated).- errors.po                       69 /  69 (100.0% translated).- floatingpoint.po                48 /  48 (100.0% translated).- index.po                         8 /   8 (100.0% translated).- inputoutput.po                  75 /  75 (100.0% translated).- interactive.po                   7 /   7 (100.0% translated).- interpreter.po                  27 /  27 (100.0% translated).- introduction.po                 79 /  79 (100.0% translated).- modules.po                      89 /  89 (100.0% translated).- stdlib.po                       48 /  48 (100.0% translated).- stdlib2.po                      45 /  45 (100.0% translated).- venv.po                         30 /  30 (100.0% translated).- whatnow.po                      18 /  18 (100.0% translated).…

Copy link

Member

AA-Turner commentedFeb 15, 2025

Because the iso639 tag for Greek isel, but the more common name isgr, we'd named the repositorypython-docs-gr. I've added the ability to have an alternative repository name. If people think that's a bad idea, we can always rename the repository as well.

Unhelpfully, there's divergence betweenISO 3166-1 alpha-2 andISO 639-1. Nevertheless, I think we should stick to ISO 639, the standard for classification of languages, for the avoidance of doubt. I hope this doesn't cause too much trouble.

Copy link

skpanagiotis commentedFeb 20, 2025

We have completed the necessary updates to successfully publish version3.12 ofpython-docs-gr:

Updatecpython submodule to the latest version.
Synced all .po files with the latest translation for3.12.
Applied translation fixes and improvements.

Merge branch 'main' into add-gr-translation

9fdb8da

Copy link

Member

AA-Turner commentedFeb 20, 2025

We have completed the necessary updates to successfully publish version 3.12 of python-docs-gr

Do you have updated numbers for the PEP 545 targets for 3.13 (which is/3/) or 3.13 (/dev/)?

Copy link

skpanagiotis commentedFeb 20, 2025

Do you have updated numbers for the PEP 545 targets for 3.13 (which is/3/) or 3.13 (/dev/)?

For 3.12

# tutorial (100.00% done)- appendix.po                     24 /  24 (100.0% translated).- appetite.po                     17 /  17 (100.0% translated).- classes.po                     149 / 149 (100.0% translated).- controlflow.po                 223 / 223 (100.0% translated).- datastructures.po              125 / 125 (100.0% translated).- errors.po                       95 /  95 (100.0% translated).- floatingpoint.po                76 /  76 (100.0% translated).- index.po                         8 /   8 (100.0% translated).- inputoutput.po                 112 / 112 (100.0% translated).- interactive.po                   7 /   7 (100.0% translated).- interpreter.po                  33 /  33 (100.0% translated).- introduction.po                119 / 119 (100.0% translated).- modules.po                     117 / 117 (100.0% translated).- stdlib.po                       67 /  67 (100.0% translated).- stdlib2.po                      65 /  65 (100.0% translated).- venv.po                         42 /  42 (100.0% translated).- whatnow.po                      18 /  18 (100.0% translated).------------------------------------------------------------------------------ functions.po                   497 / 497 (100.0% translated).------------------------------------------------------------------------------ bugs.po                         31 /  31 (100.0% translated).

For 3.13

# tutorial (98.16% done)- appendix.po                     24 /  28 ( 85.0% translated).- appetite.po                     17 /  17 (100.0% translated).- classes.po                     149 / 149 (100.0% translated).- controlflow.po                 223 / 223 (100.0% translated).- datastructures.po              125 / 125 (100.0% translated).- errors.po                       83 /  95 ( 87.0% translated), 12 fuzzy.- floatingpoint.po                76 /  76 (100.0% translated).- index.po                         8 /   8 (100.0% translated).- inputoutput.po                 112 / 112 (100.0% translated).- interactive.po                   7 /   7 (100.0% translated).- interpreter.po                  29 /  33 ( 87.0% translated), 4 fuzzy.- introduction.po                118 / 119 ( 99.0% translated), 1 fuzzy.- modules.po                     117 / 117 (100.0% translated).- stdlib.po                       65 /  67 ( 97.0% translated), 2 fuzzy.- stdlib2.po                      64 /  65 ( 98.0% translated), 1 fuzzy.- venv.po                         42 /  42 (100.0% translated).- whatnow.po                      18 /  18 (100.0% translated).-------------------------------------------------------------------------------------------- functions.po                   497 / 497 (100.0% translated).-------------------------------------------------------------------------------------------- bugs.po                         31 /  31 (100.0% translated).

Copy link

Contributor

m-aciek commentedFeb 27, 2025

There's aconvention to focus on the latest stable Python version. It would be recommended to have a 100% on 3.13 when going live with the switcher. For the time being, we could build the Greek documentation yet without including it in the switcher? (in_prod = false)

AA-Turner changed the title~~Add Greek translation and allow for alternative repo name~~Add Greek translation

Feb 27, 2025

AA-Turner reviewed

Feb 27, 2025

View reviewed changes

config.toml


		[languages.el]
		name = "Greek"
		repo_name = "python-docs-gr"

Copy link

Member

AA-TurnerFeb 27, 2025•
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

Please also update to add the newtranslated_name key.

Suggested change

repo_name = "python-docs-gr"

This comment was marked as resolved.

Copy link

MemberAuthor

lysnikolaou commentedApr 23, 2025

Yes, but it's probably best to merge this when the 3.13 docs are ready either way. We also don't have very much time to work on this, so we've been a bit slow with the port.