python · lysnikolaou · Mar 27, 2024 · Mar 26, 2024 · Mar 26, 2024 · Mar 26, 2024
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
@@ -0,0 +1,141 @@
+# Οδηγός συνεισφ
8000
οράς στο πρότζεκτ Python-Doc-Gr της κοινότητας PyGreece
+
+Eυχαριστούμε πολύ για το ενδιαφέρον σας να συμμετάσχετε στη μετάφραση των επίσημων εγγράφων της Python στα Ελληνικά!
+
+Το συγκεκριμένο πρότζεκτ έχει ξεκινήσει από το PyGreece, μια online κοινότητα εθελοντών της Python. Στο συγκεκριμένο repository θα βρείτε την ομάδα εργασίας που είναι υπεύθυνη για το πρότζεκτ. Όλο το περιεχόμενο της μετάφρασης διατηρείται από εθελοντές που συνεισφέρουν το χρόνο και την εργασία τους στην κοινότητα της Python.
+
+Σε περίπτωση που έχετε οποιαδήποτε απορία για το πρότζεκτ, μπορείτε να μας βρείτε με τους εξής τρόπους:
+
+- Μπορείτε να μπείτε στον discord server του PyGreece (πρόσκληση εδώ: https://discord.gg/evcNPRVCMB)
+
+- Μπορείτε να μας βρείτε στο linkedin [εδώ](https://www.linkedin.com/company/pygreece)
+
+Πριν ξεκινήσετε με την πρώτη σας μετάφραση θα θέλαμε να μοιραστούμε [κάποιες γενικές οδηγίες](#γενικές-οδηγίες).
+
+## Βήμα 1: Github Setup
+
+Πρέπει να κάνετε αυτό το βήμα μόνο μία φορά. Με το συγκεκριμένο fork μπορείτε να κάνετε όσα PR θέλετε.
+
+1. Για να υποβάλετε μια μετάφραση, πρέπει να έχετε ένα fork του repository , κάνοντας κλικ στο κουμπί με την κόκκινη γραμμή από κάτω (για περισσότερες πληροφορίες δείτε [εδώ](https://help.github.com/es/github/getting-started-with-github/fork-a-repo)):
+
+![fork](https://github.com/pygreece/python-docs-gr/blob/3.12/public/assets/fork_image.jpg?raw=true)
+
+2. Κάντε clone το repository που μόλις δημιουργήσατε:
+
+```bash
+git clone git@github.com:<το username σας>/python-docs-gr.git
+```
+
+3. Μεταβείτε στον φάκελο που δημιουργήθηκε:
+
+```bash
+cd python-docs-gr/
+```
+
+4. Προσθέστε το επίσημο repository ως upstream:
+
+```bash
+git remote add upstream https://github.com/pygreece/python-docs-gr.git
+```
+
+5. [Προαιρετικό βήμα] Δημιουργείστε ένα virtual environment και κάντε activate:
+
+```bash
+python -m venv env
+source env/bin/activate   # macOS y Linux
+env\Scripts\activate.bat  # Windows
+```
+
+6. [Προαιρετικό βήμα] Εγκαταστείστε τα requirements:
+
+```bash
+pip install -r requirements.txt
+```
+
+## Βήμα 2: Ποια αρχεία πρέπει να μεταφραστούν;
+
+Έχουμε [μια λίστα με issues στο GitHub](https://github.com/pygreece/python-docs-gr/issues?q=is%3Aissue+is%3Aopen+label%3Atranslation) όπου συντονίζουμε τη δουλειά που γίνεται ώστε να μην μεταφραστεί το ίδιο έγγραφο δύο φορές. Η διαδικασία μετάφρασης ενός αρχείου είναι η εξής:
+
+- Επιλέξτε οποιοδήποτε από τα issues που δεν έχουν ανατεθεί σε κάποιο άλλο άτομο.
+
+- Αφήστε ένα σχόλιο για στο issue λέγοντας ότι θέλετε να το δουλέψετε.
+
+- Περιμένετε έναν διαχειριστή να σας αναθέσει το issue.
+
+- Ξεκινήστε τη μετάφραση!
+
+## Βήμα 3: Ξεκινήστε τη μετάφραση!
+
+1. Διαλέξτε το αρχείο που θέλετε να μεταφράσετε. Το αρχείο θα υπάρχει στον τίτλο του issue που έχετε αναλάβει.
+
+2. Επιβεβαιώστε ότι είστε στο 3.12 branch (πολύ σημαντικό βήμα για να αποφύγετε να ξεκινήσετε ένα branch απο παλαιότερη έκδοση):
+
+```bash
+git checkout 3.12
+```
+
+3. Δημιουργείστε ένα branch βασισμένο στο αρχείο που θα δουλέψετε. Για παράδειγμα, εάν δουλέυετε στο αρχείο library/ast.po το όνομα του branch θα μπορούσε να είναι:
+
+```bash
+git checkout -b translate-library-ast
+```
+
+4. Αφού έχετε διαλέξει το αρχείο σας, ξεκινήστε την μετάφραση στο IDE σας. Προτείνουμε το [poedit](https://poedit.net/) ή το [vscode](https://code.visualstudio.com/).
+
+5. Εάν χρησιμοποιείτε το `poedit` είναι πιθανό πως το αρχείο σας θα έχει σωστό structure, αλλά για παν ενδεχόμενο μπορείτε να το επιβεβαιώσετε με το `powrap`. Για να το εγκαταστείσετε:
+
+```bash
+powrap <φακελος>/<ονομα_του_αρχειου>.po
+```
+
+Εάν είστε χρήστης των windows μπορείτε να δείτε περισσότερες πληροφορίες [εδώ](https://python-docs-es.readthedocs.io/es/3.12/faq.html#powrap-windows).
+
+6. **Έλεγχος ορθογραφίας**: Για να ελέγξετε την ορθοργραφία της μετάφρασης σας μπορείτε να χρησιμοποιείσετε το [pospell](https://github.com/AFPy/pospell) για να επιβεβαιώσετε ότι όλες οι λέξεις είναι γνωστές ή ανήκουν σε κάποιο από τα dictionaries. Μπορείτε επίσης να χρησιμοποιήσετε το παρακάτω script:
+
+```bash
+python scripts/check_spelling.py <dir>/<file>.po
+```
+
+Εάν κάποια από τις λέξεις δεν είναι αναγνωρισμένη από το script προσθέστε την στο dictionary και επαναλάβετε. Για παράδειγμα, εάν το αρχείο που δουλεύετε είναι το `library/ast.po` το αντίστοιχο dictionary είναι το `dictionaries/library_ast.txt`. Εάν το αρχείο που ψάχνετε δεν υπάρχει στο φάκελο dictionaries δημιουργείστε το.
+
+7. Όταν ολοκληρώσετε την μετάφραση σας, πρέπει να αποθηκεύσετε τις αλλαγές σας και να κάνετε push στο GitHub (Μην ξεχάσετε να προσθέσετε το όνομά σας στο αρχείο `TRANSLATORS`). Για παράδειγμα εάν εργαζόσασταν στη στο αρχείο `library/ast.po` τα βήματα θα ήταν:
+
+```bash
+git add library/ast.po
+git commit -m 'Translate file library/ast.po'
+git push origin translate-library-ast
+```
+
+8. Στην περιγραφή του Pull Request μπορείτε να γράψετε:
+
+```
+Closes #<αριθμός issue>
+```
+
+Έτσι θα κλείσει και το issue μόλις γίνει merge το PR.
+
+## Γενικές Οδηγίες
+
+- Σε πολλές περιπτώσεις το καλύτερο κριτήριο είναι να σκεφτούμε το λεξιλόγιο που χρησιμοποιούμε όταν εξηγούμε σε άλλο άτομο ή στη δουλειά. Σε πολλές περιπτώσεις, η αγγλική είναι πολύ καλύτερη αν θελετε πχ. να πείτε "git join".
+
+- Θα έχετε πάντα διαθέσιμο ενα preview αυτού που προτείνετε, καθώς και reviewers να σας βοηθήσουν.
+
+- Η διαδικασιά του review ειναι επίσης πολύ σημαντική. Αν έχετε ελεύθερο χρόνο θα ήταν το ίδιο σημαντικό να συνεισφέρετε κάνοντας review σε ήδη ανοιχτά Pull Requests ([περισσότερες πληροφορίες εδώ](./public/docs/review.md)).
+
+- Τα επίσημα έγγραφα της Python είναι άπειρα! Οποια εμπόδια βρείτε μπορείτε πάντα να επισημάνετε το κείμενο ως "ασαφές" ή να το αναθεωρήσετε στο μέλλον. Μην σπαταλάτε ώρες αναζητώντας την τέλεια λέξη.
+
+- Δεν πρέπει να μεταφράσετε το περιεχόμενο των :ref:..., :term:..., :dfn:..., κ.λπ.
+
+- Εάν πρέπει να χρησιμοποιήσετε αγγλικές λέξεις, θα πρέπει να τις βάλετε με πλάγιους χαρακτήρες (περιτριγυρισμένοι με αστερίσκους)
+
+- Μπορείτε να διαβάσετε τις Συχνές Ερωτήσεις για να διαβάσετε για γνωστά ζητήματα.
+
+- Εάν μεταφράσετε έναν τίτλο που είναι σύνδεσμος, μεταφράστε και τον σύνδεσμο (για παράδειγμα ένα άρθρο στη Wikipedia). Σε περίπτωση που δεν υπάρχει μετάφραση του άρθρου στη Wikipedia, αφήστε τον τίτλο αμετάφραστο.
+
+- Εάν έχετε μια ερώτηση σχετικά με μια λέξη ή όρο, γράψτε την όπως σας φαίνεται καλύτερα και σημειώστε αυτήν την παράγραφο ως "Needs Work". Επίσης, γράψτε ένα σχόλιο εξηγώντας για ποιον όρο σε αυτήν την παράγραφο δεν ήσασταν σίγουροι.
+
+- Συνιστούμε να ανοίξετε ένα Pull Request ακόμα κι αν είναι σε μορφή draft (επισημασμένο ως πρόχειρο) από τις πρώτες προσπάθειες της μετάφρασης του αρχείου σας. Με αυτόν τον τρόπο, μπορείτε να λάβετε σχόλια από την αρχή που μπορείτε να εφαρμόσετε στην υπόλοιπη μετάφραση.
+
+- Τελευταίο αλλά όχι λιγότερο σημαντικό, διασκεδάστε και βασιστείτε στη βοήθεια όλων. Περιμένουμε τα μηνύματα σας στο discord, εδώ ή στο linkedin. Ευχαριστούμε!
+
+- Για τους contributors που χρησιμοποιούν το vscode ως IDE ένα πολύ χρήσιμο add-on για τα `.po` αρχεία είναι το `gettext`. extension.
diff --git a/public/assets/fork_image.jpg b/public/assets/fork_image.jpg
diff --git a/public/docs/review.md b/public/docs/review.md
@@ -0,0 +1,27 @@
+**Σημείωση: Βοηθείστε μας να μεταφράσουμε την επίσημη μετάφραση της Python στα Ελληνικά! Μπορείτε να βρείτε περισσότερες πληροφορίες για το πως μπορείτε να συνεισφέρετε [εδώ](./CONTRIBUTING.md).**
+
+# Οδηγίες για το review των μεταφράσεων
+
+Το review ενός Pull Request είναι μια πολύ σημαντική διαδικασία για την μετάφραση των εγγράφων της Python.
+
+Για όσους δεν έχουν κάνει ποτέ review, αλλά έχετε κάνει μεταφράσεις για το πρότζεκτ, σας συνιστούμε να το δοκιμάσετε.Μέσω του review, θα μπείτε πολλές φορές στη θέση κάποιου άλλου και συχνά θα δείτε βελτίωση και των δικών σας μεταφράσεων/PR.
+
+Ένας καλός οδηγός από το Github για τα reviews είναι [εδώ](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/reviewing-changes-in-pull-requests/reviewing-proposed-changes-in-a-pull-request)
+
+## Η ανθρώπινη πλευρά
+
+Λαμβάνοντας υπόψη ότι είμαστε όλοι εθελοντές σε αυτό το έργο, είναι σημαντικό ο τρόπος που επικοινωνούμε να είναι σαφής, συνοπτικός και φιλικός. Να θυμάστε ότι στην άλλη πλευρά ενός PR υπάρχει ένα άτομο που έχει αφιερώσει χρόνο και προσπάθεια. Γι' αυτό ο τρόπος που του δίνετε σχόλια για τη δουλειά του θα επηρεάσει τη στάση του απέναντι στο έργο... και την επιθυμία του να συνεχίσει να συμμετέχει στην κοινότητά μας! Εδώ σας αφήνουμε μερικές συμβουλές ώστε το review σας να είναι εποικοδομητικό:
+
+- Πάντα να αφήνετε ένα σχόλιο στο PR που αφήνει ένα γενικό συμπέρασμα του review σας για να καταστεί σαφές στους μεταφραστές τι χρειάζεται τροποποίηση και τι όχι. Να θυμάστε πάντα να ξεκινάτε αναγνωρίζοντας τις θετικές πτυχές της δουλειάς του άλλου και στη συνέχεια μπορείτε να προσθέσετε σχόλια/προτάσεις σχετικά με τη μετάφραση.
+
+## Η πρακτική πλευρά
+
+To review πρέπει να είναι ακριβές. Με αυτόν τον τρόπο, οι μεταφραστές θα μπορούν να αναθεωρούν τη δουλειά τους και να γνωρίζουν τι πρέπει να κάνουν για να τη βελτιώσουν. Μην ξεχνάτε ότι αυτή είναι μια τεχνική μετάφραση και ως εκ τούτου, ο στόχος είναι ότι, το άτομο που τη διαβάζει μπορεί να καταλάβει πώς να χρησιμοποιεί την Python. Αυτός είναι ο λόγος για τον οποίο, αν και είναι σημαντικό η σύνταξη να είναι σωστή, ο στόχος δεν είναι να γίνει μια εντατική ανασκόπηση της χρήσης των ελληνικών, εκτός εάν ο τρόπος με τον οποίο εκφράστηκε η ιδέα καθιστά αδύνατο για κάποιον άλλο να την κατανοήσει.
+
+Για αυτό, το Github σάς προσφέρει επιλογές για να αντιμετωπίσετε ένα PR (δείτε το κουμπί `Review Changes` στην επάνω δεξιά γωνία των αρχείων που έχουν τροποποιηθεί από τους μεταφραστές):
+
+- `Comment`: Μπορείτε να αφήσετε ένα σχόλιο χωρίς απαραίτητα να εγκρίνετε το PR. Βεβαιωθείτε ότι το κάνετε με σαφήνεια, ώστε όποιος μετέφρασε να γνωρίζει ότι πρέπει να τροποποιήσει κάποια πράγματα πριν εγκριθεί το PR του.
+
+- `Approve` : Αφήστε αυτήν την επιλογή μόνο για PR που δεν χρειάζονται καμία τροποποίηση ή έχουν μόνο μερικά ορθογραφικά λάθη ή τυπογραφικά λάθη ή κάποιο σφάλμα που δεν προκαλεί μεγάλη σύγκρουση στη μετάφραση και την ενσωμάτωσή της στο κύριο branch.
+
+- `R
A3E2
equest Changes`: Χρησιμοποιήστε αυτήν την επιλογή όταν η μετάφραση χρειάζεται πολλές τροποποιήσεις που επηρεάζουν την ενσωμάτωσή της στο κύριο branch. Σε αυτήν την περίπτωση, βεβαιωθείτε επίσης ότι το μήνυμά σας είναι σαφές και φιλικό για να συνοδεύει τον μεταφραστή στη διαδικασία τροποποίησης και έγκρισης του PR.
diff --git a/scripts/check_spelling.py b/scripts/check_spelling.py
@@ -0,0 +1,56 @@
+"""
+Script to check the spelling of one, many or all .po files based
+on the custom dictionaries under the 'dictionaries/' directory.
+"""
+
+from pathlib import Path
+import sys
+import tempfile
+
+import pospell
+
+
+def check_spell(po_files=None):
+    """
+    Check spell in the given list of po_files and log the spell errors details.
+
+    If no po_files are given, check spell in all files.
+
+    args:
+        po_files: list of po_files paths.
+
+    returns:
+        - int: spell errors count.
+
+    """
+    # Read custom dictionaries
+    entries = set()
+    for filename in Path("dictionaries").glob("*.txt"):
+        with open(filename, "r") as f:
+            entries.update(
+                stripped_line
+                for stripped_line in (line.strip() for line in f.readlines())
+                if stripped_line
+            )
+
+    # Write merged dictionary file
+    output_filename = tempfile.mktemp(suffix="_merged_dict.txt")
+    with open(output_filename, "w") as f:
+        for e in entries:
+            f.write(e)
+            f.write("\n")
+
+    # Run pospell either against all files or the file given on the command line
+    if not po_files:
+        po_files = Path(".").glob("*/*.po")
+
+    detected_errors = pospell.spell_check(
+        po_files, personal_dict=output_filename, language="el_EL"
+    )
+    return detected_errors
+
+
+if __name__ == "__main__":
+    po_files = sys.argv[1:]
+    errors = check_spell(po_files)
+    sys.exit(0 if errors == 0 else -1)