Enable Read-The-Docs and fix any issues with existing translations

lysnikolaou · Aug 1, 2024 · Jun 21, 2024 · Jun 21, 2024 · Jun 21, 2024 · Jun 21, 2024
commit e4b4671a47d7e48a4638ccc0db20409384fb908f
diff --git a/.gitignore b/.gitignore
@@ -158,3 +158,6 @@ cython_debug/
 #  and can be added to the global gitignore or merged into this file.  For a more nuclear
 #  option (not recommended) you can uncomment the following to ignore the entire idea folder.
 #.idea/
+
+locales/
+.potodo/
diff --git a/.gitmodules b/.gitmodules
@@ -0,0 +1,3 @@
+[submodule "cpython"]
+	path = cpython
+	url = https://github.com/python/cpython
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -0,0 +1,9 @@
+repos:
+  - repo: https://github.com/JulienPalard/powrap
+    rev: v1.0.0
+    hooks:
+      - id: powrap
+  - repo: https://github.com/sphinx-contrib/sphinx-lint
+    rev: v0.9.1
+    hooks:
+      - id: sphinx-lint
diff --git a/.readthedocs.yaml b/.readthedocs.yaml
@@ -0,0 +1,25 @@
+# .readthedocs.yml
+# Read the Docs configuration file
+# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
+
+# Required
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3"
+
+  commands:
+  - python -m pip install -r requirements.txt
+  - make
+  - mkdir -p _readthedocs/html/
+  - cp -r cpython/Doc/build/html/* _readthedocs/html/
+
+python:
+  install:
+    - requirements: requirements.txt
+
+submodules:
+  include: all
+
diff --git a/Makefile b/Makefile
@@ -23,9 +23,10 @@
 # .po files.
 CPYTHON_CURRENT_COMMIT := 9cbde7c6ce6f7b93301a37f03dfa0c0d45e00a39
 
-CPYTHON_PATH := /home/tpetkos/github.com/python/cpython/
+CPYTHON_PATH := ./cpython
 
-LANGUAGE := gr
+LANGUAGE := el
+TRANLATION_BRANCH := main
 BRANCH := 3.12
 
 EXCLUDED := whatsnew/ c-api/
@@ -36,7 +37,7 @@ UPSTREAM := https://github.com/python/cpython
 
 PYTHON := $(shell which python3)
 MODE := html
-POSPELL_TMP_DIR := .pospell/
+POSPELL_TMP_DIR := .pospell
 JOBS := auto
 
 # Detect OS
@@ -58,7 +59,6 @@ endif
 
 .PHONY: all
 all: ensure_prerequisites
-	git -C $(CPYTHON_PATH) checkout $(CPYTHON_CURRENT_COMMIT)
 	mkdir -p locales/$(LANGUAGE)/LC_MESSAGES/
 	$(CP_CMD) -u --parents *.po */*.po locales/$(LANGUAGE)/LC_MESSAGES/
 	$(MAKE) -C $(CPYTHON_PATH)/Doc/     \
@@ -70,7 +70,6 @@ all: ensure_prerequisites
 	  -D latex_elements.inputenc=       \
 	  -D latex_elements.fontenc='       \
 	  $(MODE)
-	git -C $(CPYTHON_PATH) checkout -
 	@echo "Build success, open file://$(abspath $(CPYTHON_PATH))/Doc/build/html/index.html or run 'make serve' to see them."
 
 
@@ -83,10 +82,7 @@ ensure_prerequisites:
 	@if ! [ -d $(CPYTHON_PATH) ]; then \
 	    echo "Building the translation requires a cpython clone."; \
 	    echo "Please provide the path to a clone using the CPYTHON_PATH variable."; \
-	    echo "(Currently CPYTHON_PATH is $(CPYTHON_PATH)."; \
-	    echo "So you may want to run:"; \
-	    echo ""; \
-	    echo "  git clone $(UPSTREAM) $(CPYTHON_PATH)"; \
+	    echo "(Currently CPYTHON_PATH is $(CPYTHON_PATH).)"; \
 	    exit 1; \
 	fi
 	@if [ -n "$$(git -C $(CPYTHON_PATH) status --porcelain)" ]; then \
@@ -95,16 +91,16 @@ ensure_prerequisites:
 	    exit 1; \
 	fi
 	@if ! (blurb help >/dev/null 2>&1 && sphinx-build --version >/dev/null 2>&1); then \
-	    git -C $(CPYTHON_PATH) checkout $(BRANCH); \
 	    echo "You're missing dependencies, please enable a venv and install:"; \
 	    echo ""; \
-	    echo "  python -m pip install -r requirements.txt -r $(CPYTHON_PATH)/Doc/requirements.txt"; \
+	    echo "  python -m pip install -r requirements.txt"; \
 	    exit 1; \
 	fi
 
+
 .PHONY: serve
 serve:
-	$(MAKE) -C $(CPYTHON_PATH)/Doc/ serve
+	$(PYTHON) -c "import os, webbrowser; webbrowser.open('file://' + os.path.realpath('cpython/Doc/build/html/index.html'))"
 
 
 .PHONY: progress
@@ -123,7 +119,7 @@ wrap: ensure_prerequisites
 	@echo "Verify wrapping"
 	powrap --check --quiet *.po **/*.po
 
-SRCS = $(shell git diff --name-only $(BRANCH) | grep '.po$$')
+SRCS = $(shell git diff --name-only $(TRANLATION_BRANCH) | grep '.po$$')
 # foo/bar.po => $(POSPELL_TMP_DIR)/foo/bar.po.out
 DESTS = $(addprefix $(POSPELL_TMP_DIR)/,$(addsuffix .out,$(SRCS)))
 

diff --git a/cpython b/cpython
diff --git a/faq/programming.po b/faq/programming.po
@@ -98,7 +98,7 @@ msgid ""
 "`Eric <https://eric-ide.python-projects.org/>`_ is an IDE built on PyQt and "
 "the Scintilla editing component."
 msgstr ""
-"Το Eric <https://eric-ide.python-projects.org/>`_ είναι ένα IDE που "
+"Το `Eric <https://eric-ide.python-projects.org/>`_ είναι ένα IDE που "
 "βασίζεται στο PyQt και το component επεξεργασίας Scintilla."
 
 #: faq/programming.rst:42
@@ -114,7 +114,7 @@ msgid ""
 "`Visual Studio Code <https://code.visualstudio.com/>`_ is an IDE with "
 "debugging tools that integrates with version-control software."
 msgstr ""
-"Το Visual Studio Code <https://code.visualstudio.com/>`_ είναι ένας IDE με "
+"Το `Visual Studio Code <https://code.visualstudio.com/>`_ είναι ένας IDE με "
 "εργαλεία εντοπισμού σφαλμάτων που ενσωματώνεται με λογισμικό ελέγχου έκδοσης."
 
 #: faq/programming.rst:47
@@ -1517,7 +1517,7 @@ msgstr ""
 "διαχωρισμός της γραμμής σε λέξεις οριοθετημένες με κενά διαστήματα "
 "χρησιμοποιώντας τη μέθοδο :meth:`~str.split` αντικειμένων συμβολοσειρών και "
 "στη συνέχεια μετατροπή δεκαδικών συμβολοσειρών σε αριθμητικές τιμές "
-"χρησιμοποιώντας :func:`int` ή :func: `float`.  :meth:`!split()` υποστηρίζει "
+"χρησιμοποιώντας :func:`int` ή :func:`float`.  :meth:`!split()` υποστηρίζει "
 "μια προαιρετική παράμετρο \"sep\" που είναι χρήσιμη εάν η γραμμή "
 "χρησιμοποιεί κάτι διαφορετικό από κενό διάστημα ως διαχωριστικό."
 
@@ -1677,7 +1677,7 @@ msgid ""
 "types` and the :mod:`collections` module."
 msgstr ""
 "Χρησιμοποιήστε τις σωστές δομές δεδομένων. Μελετήστε την τεκμηρίωση για το :"
-"ref:`bltin-και το module :mod:`collections`."
+"ref:`bltin-types` και το module :mod:`collections`."
 
 #: faq/programming.rst:1101
 msgid ""
@@ -2396,7 +2396,7 @@ msgstr ""
 "μετατρέψει τη συμβολοσειρά ορίσματος σε κεφαλαία πριν καλέσει την υποκείμενη "
 "μέθοδο ``self._outfile.write()``.  Όλες οι άλλες μέθοδοι εκχωρούνται στο "
 "υποκείμενο αντικείμενο ``self._outfile``.  Το delegation ολοκληρώνεται μέσω "
-"της μεθόδου :meth:`~object.__getattr__`∙ συμβουλευτείτε το :ref:`the "
+"της μεθόδου :meth:`~object.__getattr__`. Συμβουλευτείτε το :ref:`the "
 "language reference <attribute-access>` για περισσότερες πληροφορίες σχετικά "
 "με τον έλεγχο της πρόσβασης."
 
@@ -2842,12 +2842,12 @@ msgid ""
 "2) Detecting optional arguments can be tricky when ``None`` is a valid input "
 "value.  In those situations, you can create a singleton sentinel object "
 "guaranteed to be distinct from other objects.  For example, here is how to "
-"implement a method that behaves like :meth:`dict.pop`::"
+"implement a method that behaves like :meth:`dict.pop`:"
 msgstr ""
 "2) Ο εντοπισμός προαιρετικών ορισμάτων μπορεί να είναι δύσκολος όταν το "
-"`None` είναι μια έγκυρη τιμή εισόδου.  Σε αυτές τις περιπτώσεις, μπορείτε να "
-"δημιουργήσετε ένα αντικείμενο μεμονωμένου φρουρού που είναι εγγυημένο ότι θα "
-"διαφέρει από άλλα αντικείμενα.  Για παράδειγμα, δείτε πως μπορείτε να "
+"``None`` είναι μια έγκυρη τιμή εισόδου.  Σε αυτές τις περιπτώσεις, μπορείτε "
+"να δημιουργήσετε ένα αντικείμενο μεμονωμένου φρουρού που είναι εγγυημένο ότι "
+"θα διαφέρει από άλλα αντικείμενα.  Για παράδειγμα, δείτε πως μπορείτε να "
 "εφαρμόσετε μια μέθοδο που συμπεριφέρεται σαν :meth:`dict.pop`::"
 
 #: faq/programming.rst:1901
@@ -3037,8 +3037,8 @@ msgstr ""
 "Εκτός και αν έχει οριστεί η μεταβλητή περιβάλλοντος :envvar:"
 "`PYTHONDONTWRITEBYTECODE`, η δημιουργία ενός αρχείου .pyc είναι αυτόματη εάν "
 "εισάγετε ένα module και η Python έχει τη δυνατότητα (δικαιώματα, ελεύθερος "
-"χώρος, κ.λπ...) να δημιουργήσει ένα  __pycache__`` υποκατάλογο και γράψτε το "
-"μεταγλωττισμένο module σε αυτόν τον υποκατάλογο."
+"χώρος, κ.λπ...) να δημιουργήσει ένα  ``__pycache__`` υποκατάλογο και γράψτε "
+"το μεταγλωττισμένο module σε αυτόν τον υποκατάλογο."
 
 #: faq/programming.rst:2069
 msgid ""

diff --git a/glossary.po b/glossary.po
@@ -514,7 +514,7 @@ msgid ""
 "`the dis module <bytecodes>`."
 msgstr ""
 "Μια λίστα από οδηγίες σχετικά με τα bytecode μπορεί να βρεθεί στην "
-"τεκμηρίωση για :ref:`το module dis <bytecode>`."
+"τεκμηρίωση για :ref:`το module dis <bytecodes>`."
 
 #: glossary.rst:213
 msgid "callable"
@@ -689,7 +689,7 @@ msgid ""
 "These were introduced by :pep:`492`."
 msgstr ""
 "Μια συνάρτηση που επιστρέφει ένα :term:`coroutine` αντικείμενο.  Μια "
-"συνάρτηση coroutine μπορεί να ορίζεται από τη δήλωση :keyword:`async def, "
+"συνάρτηση coroutine μπορεί να ορίζεται από τη δήλωση :keyword:`async def`, "
 "και μπορεί να περιέχει :keyword:`await`, :keyword:`async for`, και :keyword:"
 "`async with` λέξεις κλειδιά. Αυτές εισήχθησαν από το :pep:`492`."
 
@@ -739,7 +739,7 @@ msgid ""
 "definitions <class>` for more about decorators."
 msgstr ""
 "Η ίδια έννοια υπάρχει για τις κλάσεις, αλλά χρησιμοποιείται λιγότερο συχνά "
-"εκεί. Βλ. την τεκμηρίωση για :ref:`function definitions <function> και :ref:"
+"εκεί. Βλ. την τεκμηρίωση για :ref:`function definitions <function>` και :ref:"
 "`class definitions <class>` για περισσότερα σχετικά με τους decorators."
 
 #: glossary.rst:314
@@ -891,7 +891,7 @@ msgstr ""
 "προγραμματισμού σε Python προϋποθέτει την ύπαρξη έγκυρων κλειδιών ή "
 "χαρακτηριστικών και συλλαμβάνει εξαιρέσεις εάν η υπόθεση αποδεχθεί "
 "εσφαλμένη. Αυτό το καθαρό και γρήγορο στυλ χαρακτηρίζεται από την παρουσία "
-"πολλών δηλώσεων :keyword:`try` και :keyword:`except. Η τεχνική έρχεται σε "
+"πολλών δηλώσεων :keyword:`try` και :keyword:`except`. Η τεχνική έρχεται σε "
 "αντίθεση με το στυλ που είναι :term:`LBYL` κοινό σε πολλές άλλες γλώσσες, "
 "όπως η C."
 
@@ -1030,7 +1030,7 @@ msgstr ""
 "Ο :term:`filesystem encoding and error handler` διαμορφώνονται κατά την "
 "εκκίνηση της Python από τη συνάρτηση :c:func:`PyConfig_Read` βλ. :c:member:"
 "`~PyConfig.filesystem_encoding` και :c:member:`~PyConfig.filesystem_errors` "
-"μέλη του c:type:`PyConfig`."
+"μέλη του :c:type:`PyConfig`."
 
 #: glossary.rst:430
 msgid "See also the :term:`locale encoding`."
@@ -1055,7 +1055,7 @@ msgid ""
 "entry finders <path entry finder>` for use with :data:`sys.path_hooks`."
 msgstr ""
 "Από την Python 3.3, υπάρχουν δύο τύποι finder: :term:`finders μετα διαδρομής "
-"<meta path finder> για να χρήση με :data:`sys.meta_path`, και :term:`finders "
+"<meta path finder>` για χρήση με :data:`sys.meta_path`, και :term:`finders "
 "εισόδου διαδρομής <path entry finder>` για χρήση με :data:`sys.path_hooks`."
 
 #: glossary.rst:440
@@ -1532,7 +1532,7 @@ msgstr ""
 "Όταν ζητείται τερματισμός λειτουργίας, ο διερμηνέας της Python εισέρχεται σε "
 "μια ειδική φάση όπου απελευθερώνει σταδιακά όλους τους διατιθέμενους πόρους, "
 "όπως λειτουργικές μονάδες και πολλαπλές κρίσιμες εσωτερικές δομές.  Επίσης "
-"πραγματοποιεί αρκετές κλήσεις στο :term: `συλλέκτης σκουπιδιών <garbage "
+"πραγματοποιεί αρκετές κλήσεις στο :term:`συλλέκτης σκουπιδιών <garbage "
 "collection>`. Αυτό μπορεί να ενεργοποιήσει την εκτέλεση κώδικα σε "
 "καταστροφείς που ορίζονται από το χρήστη ή σε callbacks ασθενούς "
 "ανταποκρίσεις. Ο κώδικας που εκτελείται κατά τη φάση τερματισμού λειτουργίας "
@@ -1686,10 +1686,10 @@ msgstr ""
 "Υπάρχουν διάφοροι τρόποι για να δημιουργήσετε μια συνάρτηση κλειδιού. Για "
 "παράδειγμα. η μέθοδος :meth:`str.lower` μπορεί να χρησιμεύσει ως συνάρτηση "
 "κλειδί για την περίπτωση μη διάκρισης πεζών-κεφαλαίων. Εναλλακτικά, μια "
-"συνάρτηση κλειδιού μπορεί να δημιουργηθεί από μια :keyword:`lambda`έκφραση "
+"συνάρτηση κλειδιού μπορεί να δημιουργηθεί από μια :keyword:`lambda` έκφραση "
 "όπως ``lambda r: (r[0], r[2])``.  Επίσης, :func:`operator.attrgetter`, :func:"
-"`operator.itemgetter` και :func:`operator.methodcaller`είναι τρεις "
-"κατασκευαστές βασικών συναρτήσεων. Βλ. το :ref:`Sorting HOW "
+"`operator.itemgetter` και :func:`operator.methodcaller` είναι τρεις "
+"κατασκευαστές βασικών συναρτήσεων. Βλ. το :ref:`Ταξινόμηση HOW "
 "TO<sortinghowto>` για παραδείγματα δημιουργίας και χρήσης βασικών "
 "συναρτήσεων."
 
@@ -2279,7 +2279,7 @@ msgid ""
 "`path entry`."
 msgstr ""
 "Ένας :term:`finder` που επιστρέφεται από έναν καλούμενο στο :data:`sys."
-"path_hooks` (δηλαδή ένα term:`path entry hook`) που ξέρει πως να εντοπίζει "
+"path_hooks` (δηλαδή ένα :term:`path entry hook`) που ξέρει πως να εντοπίζει "
 "modules με :term:`path entry`."
 
 #: glossary.rst:959
@@ -2332,11 +2332,11 @@ msgid ""
 "`519`."
 msgstr ""
 "Ένα αντικείμενο που αντιπροσωπεύει ένα path συστήματος αρχείων. Ένα "
-"αντικείμενο path είναι είτε ένα αντικείμενο class:`str` ή :class:`bytes` που "
-"αντιπροσωπεύει ένα path ή ένα αντικείμενο που υλοποιεί το πρωτόκολλο :class:"
-"`os.PathLike`. Ένα αντικείμενο που υποστηρίζει το πρωτόκολλο :class:`os."
-"PathLike` μπορεί να μετατραπεί σε path συστήματος αρχείων :class:`str` ή :"
-"class:`bytes` καλώντας την συνάρτηση :func:`os.fspath`' τα :func:`os."
+"αντικείμενο path είναι είτε ένα αντικείμενο :class:`str` ή :class:`bytes` "
+"που αντιπροσωπεύει ένα path ή ένα αντικείμενο που υλοποιεί το πρωτόκολλο :"
+"class:`os.PathLike`. Ένα αντικείμενο που υποστηρίζει το πρωτόκολλο :class:"
+"`os.PathLike` μπορεί να μετατραπεί σε path συστήματος αρχείων :class:`str` "
+"ή :class:`bytes` καλώντας την συνάρτηση :func:`os.fspath`' τα :func:`os."
 "fsdecode` και :func:`os.fsencode` μπορούν να χρησιμοποιηθούν για την εγγύηση "
 "ενός αποτελέσματος :class:`str` ή :class:`bytes`, αντίστοιχα. Εισήχθη από "
 "τον :pep:`519`."

diff --git a/license.po b/license.po
@@ -246,8 +246,8 @@ msgid ""
 "Python software and documentation are licensed under the :ref:`PSF License "
 "Agreement <PSF-license>`."
 msgstr ""
-"To λογισμικό και η τεκμηρίωση της Python αδειοδοτούνται σύμφωνα με :ref:` "
-"Σύμβαση άδειας χρήσης PSF <PSF-license>`."
+"To λογισμικό και η τεκμηρίωση της Python αδειοδοτούνται σύμφωνα με :ref:"
+"`Σύμβαση άδειας χρήσης PSF <PSF-license>`."
 
 #: license.rst:78
 msgid ""
@@ -257,7 +257,7 @@ msgid ""
 msgstr ""
 "Ξεκινώντας από την Python 3.8.6, παραδείγματα, συνταγές και ο άλλος κώδικας "
 "στην τεκμηρίωση έχουν διπλή άδεια χρήσης, βάση της Άδεια Χρήσης PSF και της :"
-"ref: `Zero-Clause BSD άδεια <BSD0>`."
+"ref:`Zero-Clause BSD άδεια <BSD0>`."
 
 #: license.rst:82
 msgid ""

diff --git a/requirements.txt b/requirements.txt
@@ -1,2 +1,4 @@
-poutils==0.15.4
-pospell==1.3
+poutils
+pre-commit
+
+-r cpython/Doc/requirements.txt