Merge branch '3.12' into using-windows

Author: skpanagiotis

.devcontainer/devcontainer.json

@@ -0,0 +1,47 @@
+{
+  "name": "Python Translation Devcontainer",
+  "image": "python:3.12-slim",
+  "customizations": {
+    "vscode": {
+      "extensions": [
+        "eamodio.gitlens",
+        "github.vscode-pull-request-github",
+        "github.vscode-github-actions",
+        "redhat.vscode-yaml",
+        "gettext.gettext",
+        "restructuredtext.restructuredtext"
+      ],
+      "settings": {
+        "[python]": {
+          "editor.formatOnSave": true,
+          "editor.codeActionsOnSave": {
+            "source.organizeImports": "always"
+          }
+        },
+        "python.defaultInterpreterPath": "/usr/local/bin/python3",
+        "terminal.integrated.defaultProfile.linux": "zsh",
+        "terminal.integrated.profiles.linux": {
+          "zsh": {
+            "path": "/bin/zsh"
+          }
+        },
+        "terminal.integrated.env.linux": {
+          "ZSH": "/bin/zsh"
+        }
+      }
+    }
+  },
+  "features": {
+    "ghcr.io/devcontainers/features/git:1": {
+      "version": "latest"
+    },
+    "ghcr.io/devcontainers/features/common-utils:2": {}
+  },
+  "workspaceFolder": "/python-docs-gr",
+  "workspaceMount": "source=${localWorkspaceFolder},target=/python-docs-gr,type=bind,consistency=cached",
+  "postCreateCommand": "sudo apt-get update && sudo apt-get install -y hunspell hunspell-el && pip install -r ./requirements.txt",
+  "mounts": [
+    "source=pip-cache,target=/home/translator/.cache/pip,type=volume"
+  ],
+  "remoteUser": "translator"
+}

.github/workflows/precommit.yaml

@@ -14,7 +14,7 @@ jobs:
     steps:
       - uses: actions/checkout@692973e3d937129bcbf40652eb9f2f61becf3332 # v4.1.7
         with:
-          submodules: "true"
+          submodules: true
           fetch-depth: 2
       - name: Setup python
         uses: actions/setup-python@39cd14951b08e74b54015e9e001cdefcf80e669f # v5.1.1
@@ -25,5 +25,5 @@ jobs:
           sudo apt-get update
           sudo apt-get install -y hunspell hunspell-el gettext language-pack-el locales-all
       - uses: pre-commit/action@2c7b3805fd2a0fd8c1884dcaebf91fc102a13ecd # v3.0.1
-      - uses: pre-commit-ci/lite-action@9d882e7a565f7008d4faf128f27d1cb6503d4ebf # v1.0.2
+      - uses: pre-commit-ci/lite-action@5d6cc0eb514c891a40562a58a8e71576c5c7fb43 # v1.1.0
         if: always()

.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: 2c9f875913ee60ca25ce70243dc24d5b6415598c # v4.6.0
+    rev: cef0300fd0fc4d2a87a85fa2093c6b283ea36f4b # v5.0.0
     hooks:
       - id: file-contents-sorter
         files: "dictionaries/main.txt"
@@ -10,7 +10,7 @@ repos:
       - id: end-of-file-fixer
 
   - repo: https://git.afpy.org/AFPy/powrap
-    rev: df2a0a54804a6146cc9fbffb77464d4b5fe24f41 # v1.0.1
+    rev: 416de333cc58dce4453d1257769d7c9abdde95f7 # v1.0.2
     hooks:
       - id: powrap
 
@@ -23,6 +23,6 @@ repos:
           - "--personal-dict=dictionaries/main.txt"
 
   - repo: https://github.com/sphinx-contrib/sphinx-lint
-    rev: ce6d7aeab24d60b6119dbad180540bf3c9ff31da # v0.9.1
+    rev: ff671d6a030a3141634793e6d1e8909ab6091830 # v1.0.0
     hooks:
       - id: sphinx-lint

CONTRIBUTING.md

@@ -21,12 +21,11 @@
 # from which we generated our po files.  We use it here so when we
 # test build, we're building with the .rst files that generated our
 # .po files.
-CPYTHON_CURRENT_COMMIT := 9cbde7c6ce6f7b93301a37f03dfa0c0d45e00a39
+CPYTHON_CURRENT_COMMIT := 0274115585db8e26d9d1c0218fe65e5041c70f2c
 
 CPYTHON_PATH := ./cpython
 
 LANGUAGE := el
-TRANSLATION_BRANCH := main
 BRANCH := 3.12
 
 EXCLUDED := whatsnew/ c-api/
@@ -70,8 +69,10 @@ all: ensure_prerequisites
 	  -D latex_elements.inputenc=       \
 	  -D latex_elements.fontenc='       \
 	  $(MODE)
-	@echo "Build success, open file://$(abspath $(CPYTHON_PATH))/Doc/build/html/index.html or run 'make serve' to see them."
-
+	@echo "Build successful! 🎉"
+	@echo "You can now open the documentation in your browser:"
+	@echo "  file://$(abspath $(CPYTHON_PATH))/Doc/build/html/index.html"
+	@echo "Or, run 'make serve' to start a local web server for the docs."
 
 .PHONY: ensure_prerequisites
 ensure_prerequisites:
@@ -100,15 +101,27 @@ ensure_prerequisites:
 
 .PHONY: serve
 serve:
-	$(PYTHON) -c "import os, webbrowser; webbrowser.open('file://' + os.path.realpath('cpython/Doc/build/html/index.html'))"
+	@echo "Starting local server at http://localhost:8000..."
+	$(PYTHON) -m http.server -d cpython/Doc/build/html/
 
+.PHONY: preview
+preview:
+	make all && make serve
 
 .PHONY: progress
 progress:
 	@$(PYTHON) -c 'import sys; print("{:.1%}".format(int(sys.argv[1]) / int(sys.argv[2])))'  \
 	$(shell msgcat *.po */*.po | msgattrib --translated | grep -c '^msgid') \
 	$(shell msgcat *.po */*.po | grep -c '^msgid')
 
+.PHONY: spellcheck
+spellcheck:
+	$(PYTHON) scripts/check_spelling.py $(filter-out $@, $(MAKECMDGOALS))
+
+.PHONY: lint
+lint:
+	powrap *.po **/*.po && \
+	make spellcheck
 
 .PHONY: todo
 todo: ensure_prerequisites
@@ -119,7 +132,7 @@ wrap: ensure_prerequisites
 	@echo "Verify wrapping"
 	powrap --check --quiet *.po **/*.po
 
-SRCS = $(shell git diff --name-only $(TRANSLATION_BRANCH) | grep '.po$$')
+SRCS = $(shell git diff --name-only $(BRANCH) | grep '.po$$')
 # foo/bar.po => $(POSPELL_TMP_DIR)/foo/bar.po.out
 DESTS = $(addprefix $(POSPELL_TMP_DIR)/,$(addsuffix .out,$(SRCS)))
 

Makefile

@@ -3,7 +3,7 @@
 # python-docs-gr
 Η ελληνική μετάφραση των επίσημων εγγράφων της Python.
 
-## Συμφωνητικό Συνεισφοράς στην Μετάφραση των Εγγράφων
+## Συμφωνητικό Συνεισφοράς στη Μετάφραση των Εγγράφων
 
 ΣΗΜΕΙΩΣΗ ΓΙΑ ΤΗΝ ΑΔΕΙΑ ΧΡΗΣΗΣ ΤΩΝ ΜΕΤΑΦΡΑΣΕΩΝ
 
@@ -25,9 +25,9 @@
 Υποβάλλοντας την εργασία σας στο PSF για να συμπεριληφθεί στον οδηγό χρήσης της Python,
 συμφωνείτε με αυτό το έγγραφο.
 
-Το πρωτότυπο κείμενο του παραπάνου συμφωνητικού στα Αγγλικά βρίσκεται στο
+Το πρωτότυπο κείμενο του παραπάνω συμφωνητικού στα Αγγλικά βρίσκεται στο
 [PEP545](https://peps.python.org/pep-0545/#setup-the-documentation-contribution-agreement).
 
-## Πως μπορώ να βοηθήσω στην μετάφραση;
+## Πως μπορώ να βοηθήσω στη μετάφραση;
 
-Το έργο της μετάφρασης είναι εθελοντικό και στηρίζεται στους φίλους και στα μέλη της κοινότητας της Python! Κάθε συνεισφορά στην μετάφραση είναι σημαντική! Για περισότερες πληροφορίες για το πως μπορείτε να συνεισφέρετε δείτε [εδώ](./CONTRIBUTING.md).
+Το έργο της μετάφρασης είναι εθελοντικό και στηρίζεται στους φίλους και στα μέλη της κοινότητας της Python! Κάθε συνεισφορά στη μετάφραση είναι σημαντική! Για περισσότερες πληροφορίες για το πως μπορείτε να συνεισφέρετε δείτε [εδώ](./CONTRIBUTING.md).

README.md

@@ -6,3 +6,4 @@ Dimitrios Papadopoulos
 Marios Giannopoulos
 Artemis Leonardou
 Stelios Rotas
+Loukas Sakellaridis

TRANSLATORS

@@ -8,28 +8,30 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2024-03-14 12:51+0000\n"
+"POT-Creation-Date: 2025-02-17 21:03+0100\n"
 "PO-Revision-Date: 2024-03-31 19:50+0000\n"
 "Last-Translator: Theofanis Petkos <thepetk@gmail.com>\n"
 "Language-Team: PyGreece <pygreece@gmail.com>\n"
+"Language: \n"
 "MIME-Version: 1.0\n"
 "Content-Type: text/plain; charset=UTF-8\n"
 "Content-Transfer-Encoding: 8bit\n"
 
 #: about.rst:3
-msgid "About these documents"
-msgstr "Σχετικά με τα έγγραφα"
+msgid "About this documentation"
+msgstr "Σχετικά με την τεκμηρίωση"
 
 #: about.rst:6
 msgid ""
-"These documents are generated from `reStructuredText`_ sources by `Sphinx`_, "
-"a document processor specifically written for the Python documentation."
+"Python's documentation is generated from `reStructuredText`_ sources using "
+"`Sphinx`_, a documentation generator originally created for Python and now "
+"maintained as an independent project."
 msgstr ""
-"Αυτά τα έγραφα έχουν δημιουργηθεί από τα `reStructuredText`_ sources του "
-"`Sphinx`_, έναν επεξεργαστή εγγράφων που έχει δημιουργηθεί ειδικά για τα "
+"Η τεκμηρίωση της Python έχει δημιουργηθεί από τα `reStructuredText`_ sources "
+"του `Sphinx`_, έναν επεξεργαστή εγγράφων που έχει δημιουργηθεί ειδικά για τα "
 "έγγραφα της Python."
 
-#: about.rst:15
+#: about.rst:16
 msgid ""
 "Development of the documentation and its toolchain is an entirely volunteer "
 "effort, just like Python itself.  If you want to contribute, please take a "
@@ -41,39 +43,39 @@ msgstr ""
 "ρίξτε μια ματιά στη σελίδα :ref:`reporting-bugs` για πληροφορίες σχετικές με "
 "το πως να το κάνετε. Καινούριοι εθελοντές είναι πάντα ευπρόσδεκτοι!"
 
-#: about.rst:20
+#: about.rst:21
 msgid "Many thanks go to:"
 msgstr "Πολλές ευχαριστίες πηγαίνουν στους:"
 
-#: about.rst:22
+#: about.rst:23
 msgid ""
 "Fred L. Drake, Jr., the creator of the original Python documentation toolset "
-"and writer of much of the content;"
+"and author of much of the content;"
 msgstr ""
-"Fred L. Drake, Jr., τον δημιουργό των αρχικών εργαλείων των εγγράφων της "
-"Python και συντάκτη αρκετού περιεχομένου'"
+"Fred L. Drake, Jr., τον δημιουργό των αρχικών εργαλείων της τεκμηρίωσης της "
+"Python και συντάκτη αρκετού περιεχομένου·"
 
-#: about.rst:24
+#: about.rst:25
 msgid ""
 "the `Docutils <https://docutils.sourceforge.io/>`_ project for creating "
 "reStructuredText and the Docutils suite;"
 msgstr ""
 "το `Docutils <https://docutils.sourceforge.io/>`_ πρότζεκτ για την "
-"δημιουργία των εφαρμογών reStructuredText και Docutils'"
+"δημιουργία των εφαρμογών reStructuredText και Docutils·"
 
-#: about.rst:26
+#: about.rst:27
 msgid ""
 "Fredrik Lundh for his Alternative Python Reference project from which Sphinx "
 "got many good ideas."
 msgstr ""
 "Fredrik Lundh για το δικό του Alternative Python Reference πρότζεκτ από το "
 "οποίο το Sphinx πήρε πολύ καλές ιδέες."
 
-#: about.rst:31
-msgid "Contributors to the Python Documentation"
-msgstr "Συντελεστές στα έγγραφα της Python"
+#: about.rst:32
+msgid "Contributors to the Python documentation"
+msgstr "Συντελεστές στη τεκμηρίωση της Python"
 
-#: about.rst:33
+#: about.rst:34
 msgid ""
 "Many people have contributed to the Python language, the Python standard "
 "library, and the Python documentation.  See :source:`Misc/ACKS` in the "
@@ -83,7 +85,7 @@ msgstr ""
 "Python, και τα έγγραφα της Python. Δείτε :source:`Misc/ACKS` στις πηγές "
 "διανομής της Python για μια λίστα των συντελεστών."
 
-#: about.rst:37
+#: about.rst:38
 msgid ""
 "It is only with the input and contributions of the Python community that "
 "Python has such wonderful documentation -- Thank You!"