From b7d32e794e7d970f3a2c7c7925d28a2ca3655f5d Mon Sep 17 00:00:00 2001 From: Lysandros Nikolaou Date: Fri, 14 Feb 2025 12:07:07 +0100 Subject: [PATCH 1/4] Add Greek translation and allow for alternative repo name --- build_docs.py | 14 ++++++++++++-- config.toml | 4 ++++ 2 files changed, 16 insertions(+), 2 deletions(-) diff --git a/build_docs.py b/build_docs.py index a6b08bb..1c0c437 100755 --- a/build_docs.py +++ b/build_docs.py @@ -199,11 +199,21 @@ class Language: in_prod: bool sphinxopts: tuple html_only: bool = False + repo_name: str = None @property def tag(self): return self.iso639_tag.replace("_", "-").lower() + @property + def repo_url(self): + repo_name = ( + self.repo_name + if self.repo_name is not None + else f"python-docs-{self.iso639_tag}" + ) + return f"https://github.com/python/{repo_name}.git" + @staticmethod def filter(languages, language_tags=None): """Filter a sequence of languages according to --languages.""" @@ -674,7 +684,6 @@ def clone_translation(self): def translation_repo(self): """See PEP 545 for translations repository naming convention.""" - locale_repo = f"https://github.com/python/python-docs-{self.language.tag}.git" locale_clone_dir = ( self.build_root / self.version.name @@ -682,7 +691,7 @@ def translation_repo(self): / self.language.iso639_tag / "LC_MESSAGES" ) - return Repository(locale_repo, locale_clone_dir) + return Repository(self.language.repo_url, locale_clone_dir) @property def translation_branch(self): @@ -1161,6 +1170,7 @@ def parse_languages_from_config() -> list[Language]: in_prod=section.get("in_prod", default_in_prod), sphinxopts=section.get("sphinxopts", default_sphinxopts), html_only=section.get("html_only", default_html_only), + repo_name=section.get("repo_name"), ) for iso639_tag, section in config["languages"].items() ] diff --git a/config.toml b/config.toml index b0994ad..5d819c6 100644 --- a/config.toml +++ b/config.toml @@ -95,3 +95,7 @@ sphinxopts = [ '-D latex_elements.inputenc=', '-D latex_elements.fontenc=\\usepackage{xeCJK}', ] + +[languages.el] +name = "Greek" +repo_name = "python-docs-gr" From 8a5e998f410e24657fa060d92fd94257e25dfb18 Mon Sep 17 00:00:00 2001 From: Lysandros Nikolaou Date: Thu, 19 Jun 2025 14:00:35 +0200 Subject: [PATCH 2/4] Revert changes to build_docs to allow for different repo_name --- build_docs.py | 14 ++------------ 1 file changed, 2 insertions(+), 12 deletions(-) diff --git a/build_docs.py b/build_docs.py index 4d66f9a..fb51cf9 100755 --- a/build_docs.py +++ b/build_docs.py @@ -200,21 +200,11 @@ class Language: in_prod: bool sphinxopts: tuple html_only: bool = False - repo_name: str = None @property def tag(self): return self.iso639_tag.replace("_", "-").lower() - @property - def repo_url(self): - repo_name = ( - self.repo_name - if self.repo_name is not None - else f"python-docs-{self.iso639_tag}" - ) - return f"https://github.com/python/{repo_name}.git" - @property def switcher_label(self): if self.translated_name: @@ -691,6 +681,7 @@ def clone_translation(self): def translation_repo(self): """See PEP 545 for translations repository naming convention.""" + locale_repo = f"https://github.com/python/python-docs-{self.language.tag}.git" locale_clone_dir = ( self.build_root / self.version.name @@ -698,7 +689,7 @@ def translation_repo(self): / self.language.iso639_tag / "LC_MESSAGES" ) - return Repository(self.language.repo_url, locale_clone_dir) + return Repository(locale_repo, locale_clone_dir) @property def translation_branch(self): @@ -1179,7 +1170,6 @@ def parse_languages_from_config() -> list[Language]: in_prod=section.get("in_prod", default_in_prod), sphinxopts=section.get("sphinxopts", default_sphinxopts), html_only=section.get("html_only", default_html_only), - repo_name=section.get("repo_name"), ) for iso639_tag, section in config["languages"].items() ] From 9f0af048d76090cc517746717fed3ecc560cfd60 Mon Sep 17 00:00:00 2001 From: Lysandros Nikolaou Date: Thu, 19 Jun 2025 14:01:11 +0200 Subject: [PATCH 3/4] Fix config --- config.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/config.toml b/config.toml index 03a63ec..cb592f5 100644 --- a/config.toml +++ b/config.toml @@ -127,4 +127,4 @@ sphinxopts = [ [languages.el] name = "Greek" -repo_name = "python-docs-gr" +translated_name = "Ελληνικά" From 1e8a482bc7e335941f7b7f926b510bcbb16144b4 Mon Sep 17 00:00:00 2001 From: Lysandros Nikolaou Date: Thu, 19 Jun 2025 14:09:43 +0200 Subject: [PATCH 4/4] Change order --- config.toml | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/config.toml b/config.toml index cb592f5..4a5958f 100644 --- a/config.toml +++ b/config.toml @@ -15,6 +15,10 @@ sphinxopts = [ "-D latex_elements.fontenc=", ] +[languages.el] +name = "Greek" +translated_name = "Ελληνικά" + [languages.en] name = "English" @@ -124,7 +128,3 @@ sphinxopts = [ '-D latex_elements.inputenc=', '-D latex_elements.fontenc=\\usepackage{xeCJK}', ] - -[languages.el] -name = "Greek" -translated_name = "Ελληνικά"