From 9f8dbd5eedcc4f45a85d6382903ceccc5897af45 Mon Sep 17 00:00:00 2001 From: "localizeflow[bot]" Date: Fri, 6 Feb 2026 11:30:25 +0000 Subject: [PATCH] chore(i18n): sync translations with latest source changes (chunk 1/1, 6 changes) --- translations/el/.co-op-translator.json | 2 +- translations/el/AGENTS.md | 288 ++++++++++++------------- translations/pl/.co-op-translator.json | 2 +- translations/pl/AGENTS.md | 270 +++++++++++------------ translations/tr/.co-op-translator.json | 2 +- translations/tr/AGENTS.md | 286 ++++++++++++------------ 6 files changed, 425 insertions(+), 425 deletions(-) diff --git a/translations/el/.co-op-translator.json b/translations/el/.co-op-translator.json index 9d815b138..d500ac56e 100644 --- a/translations/el/.co-op-translator.json +++ b/translations/el/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T08:43:08+00:00", + "translation_date": "2026-02-06T11:30:21+00:00", "source_file": "AGENTS.md", "language_code": "el" }, diff --git a/translations/el/AGENTS.md b/translations/el/AGENTS.md index 8326f3684..2ab9a7bb4 100644 --- a/translations/el/AGENTS.md +++ b/translations/el/AGENTS.md @@ -2,27 +2,27 @@ ## Επισκόπηση Έργου -Αυτό είναι ένα εκπαιδευτικό αποθετήριο διδακτικού προγράμματος για τη διδασκαλία των βασικών της ανάπτυξης ιστοσελίδων σε αρχάριους. Το πρόγραμμα σπουδών είναι ένα ολοκληρωμένο 12-εβδομάδων μάθημα που έχει αναπτυχθεί από τους Microsoft Cloud Advocates, περιλαμβάνοντας 24 πρακτικά μαθήματα που καλύπτουν JavaScript, CSS και HTML. +Αυτό είναι ένα εκπαιδευτικό αποθετήριο προγράμματος σπουδών για τη διδασκαλία των βασικών της ανάπτυξης ιστού σε αρχάριους. Το πρόγραμμα σπουδών είναι ένα ολοκληρωμένο μάθημα 12 εβδομάδων που αναπτύχθηκε από τους Microsoft Cloud Advocates, περιλαμβάνοντας 24 πρακτικά μαθήματα με JavaScript, CSS και HTML. -### Κύρια Στοιχεία +### Βασικά Συστατικά -- **Εκπαιδευτικό Περιεχόμενο**: 24 δομημένα μαθήματα οργανωμένα σε μονάδες με βάση έργα -- **Πρακτικά Έργα**: Terrarium, Παιχνίδι Πληκτρολόγησης, Επέκταση Περιηγητή, Παιχνίδι Διαστήματος, Εφαρμογή Τράπεζας, Κειμενογράφος, και Βοηθός Συνομιλίας AI +- **Εκπαιδευτικό Περιεχόμενο**: 24 οργανωμένα μαθήματα σε μονάδες με βάση το έργο +- **Πρακτικά Έργα**: Terrarium, Παιχνίδι Πληκτρολόγησης, Πρόσθετο Περιηγητή, Παιχνίδι Διαστήματος, Τραπεζική Εφαρμογή, Επεξεργαστής Κώδικα και Βοηθός Συνομιλίας AI - **Διαδραστικά Κουίζ**: 48 κουίζ με 3 ερωτήσεις το καθένα (αξιολογήσεις πριν και μετά το μάθημα) -- **Υποστήριξη Πολλαπλών Γλωσσών**: Αυτόματες μεταφράσεις για πάνω από 50 γλώσσες μέσω GitHub Actions +- **Υποστήριξη Πολλών Γλωσσών**: Αυτόματες μεταφράσεις σε 50+ γλώσσες μέσω GitHub Actions - **Τεχνολογίες**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (για έργα AI) ### Αρχιτεκτονική - Εκπαιδευτικό αποθετήριο με δομή βασισμένη στα μαθήματα -- Κάθε φάκελος μαθήματος περιέχει README, παραδείγματα κώδικα, και λύσεις -- Αυτόνομα έργα σε ξεχωριστούς φακέλους (quiz-app, διάφορα έργα μαθημάτων) +- Κάθε φάκελος μαθήματος περιέχει README, παραδείγματα κώδικα και λύσεις +- Αυτόνομα έργα σε ξεχωριστά καταλόγους (quiz-app, διάφορα έργα μαθημάτων) - Σύστημα μετάφρασης με χρήση GitHub Actions (co-op-translator) -- Τεκμηρίωση διατίθεται μέσω Docsify και ως PDF +- Τεκμηρίωση εξυπηρετείται μέσω Docsify και είναι διαθέσιμη και σε PDF ## Εντολές Ρύθμισης -Αυτό το αποθετήριο προορίζεται κυρίως για κατανάλωση εκπαιδευτικού περιεχομένου. Για εργασία με συγκεκριμένα έργα: +Αυτό το αποθετήριο είναι κυρίως για κατανάλωση εκπαιδευτικού περιεχομένου. Για εργασία με συγκεκριμένα έργα: ### Ρύθμιση Κύριου Αποθετηρίου @@ -51,12 +51,12 @@ npm run lint # Εκτέλεση ESLint npm run format # Μορφοποίηση με Prettier ``` -### Έργα Επέκτασης Περιηγητή +### Έργα Πρόσθετων Περιηγητή ```bash cd 5-browser-extension/solution npm install -# Ακολουθήστε τις οδηγίες φόρτωσης επεκτάσεων ειδικές για τον περιηγητή +# Ακολουθήστε τις οδηγίες φόρτωσης επεκτάσεων ανά πρόγραμμα περιήγησης ``` ### Έργα Παιχνιδιού Διαστήματος @@ -67,12 +67,12 @@ npm install # Ανοίξτε το index.html στον περιηγητή ή χρησιμοποιήστε το Live Server ``` -### Έργο Συνομιλίας (Python Backend) +### Έργο Συνομιλίας (Backend Python) ```bash cd 9-chat-project/solution/backend/python pip install openai -# Ορισμός μεταβλητής περιβάλλοντος GITHUB_TOKEN +# Ορίστε τη μεταβλητή περιβάλλοντος GITHUB_TOKEN python api.py ``` @@ -80,182 +80,182 @@ python api.py ### Για Συνεργάτες Περιεχομένου -1. **Κλωνοποιήστε το αποθετήριο** στον λογαριασμό σας στο GitHub -2. **Κατεβάστε το fork τοπικά** -3. **Δημιουργήστε νέο κλάδο** για τις αλλαγές σας +1. **Κάντε fork το αποθετήριο** στον λογαριασμό σας στο GitHub +2. **Κλωνοποιήστε το fork** τοπικά +3. **Δημιουργήστε νέο branch** για τις αλλαγές σας 4. Κάντε αλλαγές στο περιεχόμενο των μαθημάτων ή στα παραδείγματα κώδικα -5. Δοκιμάστε τυχόν αλλαγές κώδικα στους αντίστοιχους φακέλους έργων -6. Υποβάλετε pull requests ακολουθώντας τις κατευθυντήριες γραμμές συνεισφοράς +5. Δοκιμάστε τις αλλαγές σε κώδικα στους σχετικούς φακέλους έργων +6. Υποβάλετε pull requests ακολουθώντας τις οδηγίες συνεισφοράς ### Για Μαθητές -1. Κλωνοποιήστε ή fork το αποθετήριο +1. Κάντε fork ή κλώνο του αποθετηρίου 2. Μεταβείτε στους φακέλους μαθημάτων σειριακά 3. Διαβάστε τα αρχεία README για κάθε μάθημα -4. Ολοκληρώστε τα κουίζ προ-μαθήματος στο https://ff-quizzes.netlify.app/web/ -5. Μελετήστε τα παραδείγματα κώδικα στους φακέλους μαθημάτων -6. Ολοκληρώστε τα καθήκοντα και προκλήσεις -7. Κάντε τα κουίζ μετα-μαθήματος +4. Ολοκληρώστε τα προκαταρκτικά κουίζ στο https://ff-quizzes.netlify.app/web/ +5. Δουλέψτε με τα παραδείγματα κώδικα στους φακέλους μαθημάτων +6. Ολοκληρώστε εργασίες και προκλήσεις +7. Πραγματοποιήστε τα μετα-μαθηματικά κουίζ ### Ζωντανή Ανάπτυξη -- **Τεκμηρίωση**: Εκτελέστε `docsify serve` στη ρίζα (θύρα 3000) +- **Τεκμηρίωση**: Εκτελέστε `docsify serve` στον ριζικό φάκελο (θύρα 3000) - **Quiz App**: Εκτελέστε `npm run dev` στον φάκελο quiz-app -- **Έργα**: Χρησιμοποιήστε την επέκταση Live Server του VS Code για HTML έργα +- **Έργα**: Χρησιμοποιήστε την επέκταση Live Server του VS Code για έργα HTML - **API Έργα**: Εκτελέστε `npm start` στους αντίστοιχους φακέλους API ## Οδηγίες Δοκιμών -### Δοκιμές Quiz App +### Δοκιμή Quiz App ```bash cd quiz-app -npm run lint # Έλεγχος για προβλήματα στυλ κώδικα -npm run build # Επιβεβαίωση επιτυχίας κατασκευής +npm run lint # Ελέγξτε για ζητήματα στυλ κώδικα +npm run build # Επαληθεύστε ότι η κατασκευή είναι επιτυχής ``` -### Δοκιμές API Τράπεζας +### Δοκιμή Bank API ```bash cd 7-bank-project/api -npm run lint # Ελέγξτε για ζητήματα στυλ κώδικα -node server.js # Επαληθεύστε ότι ο διακομιστής ξεκινά χωρίς σφάλματα +npm run lint # Έλεγχος για προβλήματα στο στυλ κώδικα +node server.js # Επιβεβαίωση ότι ο διακομιστής ξεκινά χωρίς σφάλματα ``` ### Γενική Προσέγγιση Δοκιμών -- Πρόκειται για εκπαιδευτικό αποθετήριο χωρίς ολοκληρωμένες αυτοματοποιημένες δοκιμές -- Οι μη αυτόματες δοκιμές εστιάζουν σε: - - Τα παραδείγματα κώδικα να τρέχουν χωρίς σφάλματα +- Αυτό είναι ένα εκπαιδευτικό αποθετήριο χωρίς ολοκληρωμένες αυτοματοποιημένες δοκιμές +- Οι χειροκίνητες δοκιμές εστιάζουν στα: + - Παραδείγματα κώδικα να εκτελούνται χωρίς σφάλματα - Οι σύνδεσμοι στην τεκμηρίωση να λειτουργούν σωστά - Οι κατασκευές έργων να ολοκληρώνονται επιτυχώς - - Τα παραδείγματα να ακολουθούν τις βέλτιστες πρακτικές + - Τα παραδείγματα να ακολουθούν βέλτιστες πρακτικές ### Έλεγχοι Πριν την Υποβολή - Εκτελέστε `npm run lint` σε φακέλους με package.json - Επαληθεύστε ότι οι σύνδεσμοι markdown είναι έγκυροι - Δοκιμάστε παραδείγματα κώδικα σε περιηγητή ή Node.js -- Ελέγξτε ότι οι μεταφράσεις διατηρούν τη σωστή δομή +- Βεβαιωθείτε ότι οι μεταφράσεις διατηρούν την κατάλληλη δομή ## Οδηγίες Στυλ Κώδικα ### JavaScript - Χρησιμοποιήστε σύγχρονη σύνταξη ES6+ -- Ακολουθήστε τις τυπικές διαμορφώσεις ESLint που παρέχονται στα έργα -- Χρησιμοποιήστε ουσιαστικά ονόματα μεταβλητών και συναρτήσεων για εκπαιδευτική σαφήνεια +- Ακολουθήστε τις τυπικές ρυθμίσεις ESLint που παρέχονται στα έργα +- Χρησιμοποιήστε σημασιολογικά ονόματα μεταβλητών και συναρτήσεων για εκπαιδευτική σαφήνεια - Προσθέστε σχόλια που εξηγούν έννοιες για τους μαθητές -- Μορφοποιήστε χρησιμοποιώντας Prettier όπου έχει ρυθμιστεί +- Μορφοποιήστε με Prettier όπου είναι ρυθμισμένο ### HTML/CSS - Σημασιολογικά στοιχεία HTML5 -- Αρχές σχεδιασμού για ανταποκρινόμενο περιεχόμενο +- Αρχές σχεδιασμού με ανταπόκριση - Καθαρή ονοματολογία κλάσεων - Σχόλια που εξηγούν τεχνικές CSS για τους μαθητές ### Python -- Κατευθυντήριες γραμμές στυλ PEP 8 +- Οδηγίες στυλ PEP 8 - Καθαρά, εκπαιδευτικά παραδείγματα κώδικα -- Type hints όπου είναι χρήσιμα για τη μάθηση +- Υποδείξεις τύπων όπου βοηθούν στη μάθηση -### Τεκμηρίωση σε Markdown +### Τεκμηρίωση Markdown - Σαφής ιεραρχία επικεφαλίδων -- Κώδικας με δηλωμένη γλώσσα -- Σύνδεσμοι προς επιπλέον πόρους -- Στιγμιότυπα και εικόνες στον φάκελο `images/` -- Εναλλακτικό κείμενο για εικόνες για προσβασιμότητα +- Μπλοκ κώδικα με καθορισμό γλώσσας +- Σύνδεσμοι προς πρόσθετους πόρους +- Στιγμιότυπα και εικόνες στους φακέλους `images/` +- Κείμενο alt για τις εικόνες για προσβασιμότητα ### Οργάνωση Αρχείων -- Μαθήματα αριθμημένα ακολουθιακά (1-getting-started-lessons, 2-js-basics, κτλ.) +- Μαθήματα αριθμημένα διαδοχικά (1-getting-started-lessons, 2-js-basics, κλπ.) - Κάθε έργο έχει φακέλους `solution/` και συχνά `start/` ή `your-work/` -- Εικόνες αποθηκεύονται σε φακέλους `images/` ειδικούς για κάθε μάθημα -- Μεταφράσεις σε δομή `translations/{language-code}/` +- Εικόνες αποθηκευμένες σε φακέλους `images/` ειδικούς για κάθε μάθημα +- Μεταφράσεις σε διάταξη `translations/{language-code}/` -## Δόμηση και Ανάπτυξη +## Κατασκευή και Ανάπτυξη ### Ανάπτυξη Quiz App (Azure Static Web Apps) -Το quiz-app είναι διαμορφωμένο για ανάπτυξη Azure Static Web Apps: +Το quiz-app είναι ρυθμισμένο για ανάπτυξη σε Azure Static Web Apps: ```bash cd quiz-app -npm run build # Δημιουργεί φάκελο dist/ -# Αναπτύσσει μέσω ροής εργασίας GitHub Actions κατά το push στο main +npm run build # Δημιουργεί το φάκελο dist/ +# Αναπτύσσει μέσω της ροής εργασίας GitHub Actions κατά την ώθηση στο main ``` -Διαμόρφωση Azure Static Web Apps: +Ρυθμίσεις Azure Static Web Apps: - **Τοποθεσία εφαρμογής**: `/quiz-app` - **Τοποθεσία εξόδου**: `dist` - **Ροή εργασίας**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` -### Δημιουργία PDF Τεκμηρίωσης +### Δημιουργία PDF τεκμηρίωσης ```bash npm install # Εγκαταστήστε το docsify-to-pdf -npm run convert # Δημιουργήστε PDF από docs +npm run convert # Δημιουργήστε PDF από τα έγγραφα ``` ### Τεκμηρίωση Docsify ```bash npm install -g docsify-cli # Εγκαταστήστε το Docsify παγκοσμίως -docsify serve # Παρέχετε σε localhost:3000 +docsify serve # Εξυπηρετήστε στο localhost:3000 ``` -### Ειδικές Κατασκευές Έργων +### Κατασκευές ειδικές για έργο -Κάθε φάκελος έργου μπορεί να έχει δική του διαδικασία κατασκευής: -- Vue έργα: `npm run build` δημιουργεί αρχεία παραγωγής -- Στατικά έργα: Δεν υπάρχει βήμα κατασκευής, τα αρχεία σερβίρονται απευθείας +Κάθε φάκελος έργου μπορεί να έχει τη δική του διαδικασία κατασκευής: +- Έργα Vue: `npm run build` δημιουργεί παραγωγικά πακέτα +- Στατικά έργα: Δεν υπάρχει βήμα κατασκευής, εξυπηρετούνται τα αρχεία απευθείας -## Οδηγίες Υποβολής Pull Request +## Οδηγίες Pull Request -### Μορφή Τίτλου +### Μορφοποίηση Τίτλου -Χρησιμοποιήστε σαφείς, περιγραφικούς τίτλους που υποδεικνύουν το πεδίο της αλλαγής: -- `[Quiz-app] Προσθήκη νέου κουίζ για μάθημα X` -- `[Lesson-3] Διόρθωση λάθους στο έργο terrarium` +Χρησιμοποιήστε σαφείς, περιγραφικούς τίτλους που υποδεικνύουν τον τομέα αλλαγής: +- `[Quiz-app] Προσθήκη νέου κουίζ για μάθημα Χ` +- `[Lesson-3] Διόρθωση ορθογραφικού λάθους στο έργο terrarium` - `[Translation] Προσθήκη ισπανικής μετάφρασης για μάθημα 5` -- `[Docs] Ενημέρωση οδηγιών εγκατάστασης` +- `[Docs] Ενημέρωση οδηγιών ρύθμισης` -### Απαιτούμενοι Έλεγχοι +### Απαραίτητοι Έλεγχοι Πριν την υποβολή PR: 1. **Ποιότητα Κώδικα**: - - Εκτελέστε `npm run lint` στους αντίστοιχους φακέλους έργων - - Διορθώστε όλα τα σφάλματα και τις προειδοποιήσεις lint + - Εκτελέστε `npm run lint` στους σχετικούς φακέλους έργων + - Διορθώστε όλα τα σφάλματα και προειδοποιήσεις lint 2. **Επαλήθευση Κατασκευής**: - - Εκτελέστε `npm run build` εφόσον απαιτείται + - Εκτελέστε `npm run build` αν εφαρμόζεται - Βεβαιωθείτε ότι δεν υπάρχουν σφάλματα κατασκευής -3. **Επικύρωση Συνδέσμων**: +3. **Επαλήθευση Συνδέσμων**: - Δοκιμάστε όλους τους συνδέσμους markdown - Επαληθεύστε ότι οι αναφορές εικόνων λειτουργούν 4. **Έλεγχος Περιεχομένου**: - - Διορθώστε ορθογραφικά και γραμματικά λάθη + - Διορθώστε ορθογραφία και γραμματική - Βεβαιωθείτε ότι τα παραδείγματα κώδικα είναι σωστά και εκπαιδευτικά - - Επαληθεύστε ότι οι μεταφράσεις διατηρούν την αρχική σημασία + - Επιβεβαιώστε ότι οι μεταφράσεις διατηρούν την αρχική έννοια ### Απαιτήσεις Συνεισφοράς -- Αποδοχή Microsoft CLA (αυτόματος έλεγχος κατά το πρώτο PR) -- Ακολουθήστε τον [Κώδικα Συμπεριφοράς Ανοιχτού Κώδικα της Microsoft](https://opensource.microsoft.com/codeofconduct/) +- Αποδοχή Microsoft CLA (αυτόματος έλεγχος στην πρώτη PR) +- Ακολουθήστε τον [Κώδικα Συμπεριφοράς Ανοιχτού Κώδικα Microsoft](https://opensource.microsoft.com/codeofconduct/) - Δείτε το [CONTRIBUTING.md](./CONTRIBUTING.md) για λεπτομερείς οδηγίες -- Αναφέρετε αριθμούς θεμάτων στην περιγραφή PR αν ισχύει +- Αναφέρετε τους αριθμούς θεμάτων στην περιγραφή PR αν ισχύει -### Διαδικασία Αναθεώρησης +### Διαδικασία Επισκόπησης -- Τα PR εξετάζονται από τους διαχειριστές και την κοινότητα -- Δίνεται προτεραιότητα στην εκπαιδευτική σαφήνεια -- Τα παραδείγματα κώδικα πρέπει να ακολουθούν τις τρέχουσες βέλτιστες πρακτικές +- Οι PR ελέγχονται από διαχειριστές και κοινότητα +- Προτεραιότητα στην εκπαιδευτική σαφήνεια +- Τα παραδείγματα κώδικα να ακολουθούν τις τρέχουσες βέλτιστες πρακτικές - Οι μεταφράσεις ελέγχονται για ακρίβεια και πολιτισμική καταλληλότητα ## Σύστημα Μετάφρασης @@ -263,20 +263,20 @@ docsify serve # Παρέχετε σε localhost:3000 ### Αυτόματη Μετάφραση - Χρησιμοποιεί GitHub Actions με ροή εργασίας co-op-translator -- Μεταφράζει σε πάνω από 50 γλώσσες αυτόματα +- Μεταφράζει σε 50+ γλώσσες αυτόματα - Αρχεία πηγής στους κύριους φακέλους - Μεταφρασμένα αρχεία στους φακέλους `translations/{language-code}/` ### Προσθήκη Χειροκίνητων Βελτιώσεων Μετάφρασης -1. Εντοπίστε το αρχείο σε `translations/{language-code}/` +1. Εντοπίστε αρχείο στο `translations/{language-code}/` 2. Κάντε βελτιώσεις διατηρώντας τη δομή 3. Βεβαιωθείτε ότι τα παραδείγματα κώδικα παραμένουν λειτουργικά -4. Δοκιμάστε τυχόν τοπικό περιεχόμενο κουίζ +4. Δοκιμάστε τυχόν τοπικοποιημένο περιεχόμενο κουίζ ### Μεταδεδομένα Μετάφρασης -Τα μεταφρασμένα αρχεία περιλαμβάνουν κεφαλίδα μεταδεδομένων: +Τα μεταφρασμένα αρχεία περιλαμβάνουν επικεφαλίδα μεταδεδομένων: ```markdown ``` -## Ανίχνευση και Αντιμετώπιση Προβλημάτων +## Αποσφαλμάτωση και Επίλυση Προβλημάτων -### Συνηθισμένα Προβλήματα +### Συνήθη Προβλήματα -**Η εφαρμογή quiz δεν ξεκινά**: -- Ελέγξτε την έκδοση Node.js (συστήνεται v14+) -- Διαγράψτε `node_modules` και `package-lock.json`, εκτελέστε ξανά `npm install` -- Ελέγξτε για συγκρούσεις θυρών (προεπιλογή: Vite χρησιμοποιεί θύρα 5173) +**Το Quiz app δεν ξεκινά**: +- Ελέγξτε την έκδοση Node.js (συνιστάται v14+) +- Διαγράψτε `node_modules` και `package-lock.json`, τρέξτε ξανά `npm install` +- Ελέγξτε για συγκρούσεις θυρών (προεπιλογή: Vite χρησιμοποιεί τη θύρα 5173) **Ο διακομιστής API δεν ξεκινά**: -- Επαληθεύστε ότι η έκδοση Node.js είναι τουλάχιστον 10 -- Ελέγξτε αν η θύρα είναι ήδη σε χρήση -- Βεβαιωθείτε ότι όλες οι εξαρτήσεις έχουν εγκατασταθεί με `npm install` +- Επαληθεύστε ότι η έκδοση Node.js είναι αρκετή (node >=10) +- Ελέγξτε αν η θύρα χρησιμοποιείται ήδη +- Βεβαιωθείτε ότι έχουν εγκατασταθεί όλες οι εξαρτήσεις με `npm install` -**Η επέκταση περιηγητή δεν φορτώνει**: -- Επαληθεύστε ότι το manifest.json είναι σωστά διαμορφωμένο -- Ελέγξτε για σφάλματα στην κονσόλα περιηγητή -- Ακολουθήστε τις οδηγίες εγκατάστασης επέκτασης συγκεκριμένου περιηγητή +**Το πρόσθετο περιηγητή δεν φορτώνει**: +- Βεβαιωθείτε ότι το manifest.json είναι σωστά μορφοποιημένο +- Ελέγξτε για σφάλματα στην κονσόλα του περιηγητή +- Ακολουθήστε τις οδηγίες εγκατάστασης συγκεκριμένες για τον περιηγητή -**Προβλήματα έργου συνομιλίας Python**: +**Προβλήματα στο έργο Python συνομιλίας**: - Βεβαιωθείτε ότι το πακέτο OpenAI είναι εγκατεστημένο: `pip install openai` -- Επαληθεύστε ότι η μεταβλητή περιβάλλοντος GITHUB_TOKEN είναι ορισμένη -- Ελέγξτε τα δικαιώματα πρόσβασης στα GitHub Models +- Επαληθεύστε ότι η μεταβλητή περιβάλλοντος GITHUB_TOKEN έχει οριστεί +- Ελέγξτε δικαιώματα πρόσβασης GitHub Models -**Τα Docsify δεν σερβίρουν τεκμηρίωση**: +**Docsify δεν εξυπηρετεί την τεκμηρίωση**: - Εγκαταστήστε docsify-cli παγκοσμίως: `npm install -g docsify-cli` -- Εκτελέστε από τη ρίζα του αποθετηρίου -- Ελέγξτε ότι το `docs/_sidebar.md` υπάρχει +- Τρέξτε από τον ριζικό φάκελο αποθετηρίου +- Ελέγξτε ότι υπάρχει το `docs/_sidebar.md` -### Συμβουλές Περιβάλλοντος Ανάπτυξης +### Συμβουλές για το Περιβάλλον Ανάπτυξης - Χρησιμοποιήστε VS Code με επέκταση Live Server για έργα HTML -- Εγκαταστήστε τις επεκτάσεις ESLint και Prettier για ομοιόμορφη μορφοποίηση -- Χρησιμοποιήστε τα DevTools του περιηγητή για αποσφαλμάτωση JavaScript -- Για έργα Vue, εγκαταστήστε την επέκταση Vue DevTools για τον περιηγητή +- Εγκαταστήστε επεκτάσεις ESLint και Prettier για συνεπές format +- Χρησιμοποιήστε DevTools περιηγητή για αποσφαλμάτωση JavaScript +- Για έργα Vue, εγκαταστήστε την επέκταση Vue DevTools του περιηγητή ### Θεωρήσεις Απόδοσης -- Μεγάλος αριθμός μεταφρασμένων αρχείων (πάνω από 50 γλώσσες) σημαίνει μεγάλα πλήρη clones -- Χρησιμοποιήστε shallow clone αν εργάζεστε μόνο με περιεχόμενο: `git clone --depth 1` -- Αποκλείστε τις μεταφράσεις από τις αναζητήσεις όταν εργάζεστε με αγγλικό περιεχόμενο -- Οι διαδικασίες build μπορεί να είναι αργές στην πρώτη εκτέλεση (npm install, Vite build) +- Μεγάλος αριθμός μεταφρασμένων αρχείων (50+ γλώσσες) σημαίνει μεγάλους ολικούς κλώνους +- Χρησιμοποιήστε shallow clone εάν εργάζεστε μόνο στο περιεχόμενο: `git clone --depth 1` +- Εξαιρέστε τις μεταφράσεις από τις αναζητήσεις όταν εργάζεστε σε αγγλικό περιεχόμενο +- Οι διαδικασίες κατασκευής μπορεί να είναι αργές στην πρώτη εκτέλεση (npm install, Vite build) ## Θεωρήσεις Ασφαλείας ### Μεταβλητές Περιβάλλοντος -- Δεν πρέπει ποτέ να αποθηκεύονται κλειδιά API στο αποθετήριο +- Τα κλειδιά API δεν πρέπει ποτέ να δεσμεύονται στο αποθετήριο - Χρησιμοποιήστε αρχεία `.env` (ήδη στο `.gitignore`) - Τεκμηριώστε τις απαιτούμενες μεταβλητές περιβάλλοντος στα README των έργων ### Έργα Python -- Χρησιμοποιείτε εικονικά περιβάλλοντα: `python -m venv venv` -- Διατηρείτε τις εξαρτήσεις ενημερωμένες -- Τα tokens GitHub πρέπει να έχουν μόνο τα απαραίτητα δικαιώματα +- Χρησιμοποιήστε εικονικά περιβάλλοντα: `python -m venv venv` +- Κρατήστε τις εξαρτήσεις ενημερωμένες +- Τα tokens GitHub πρέπει να έχουν ελάχιστα απαιτούμενα δικαιώματα -### Πρόσβαση σε GitHub Models +### Πρόσβαση GitHub Models -- Απαιτούνται Personal Access Tokens (PAT) για πρόσβαση σε GitHub Models +- Απαιτούνται Personal Access Tokens (PAT) για GitHub Models - Τα tokens πρέπει να αποθηκεύονται ως μεταβλητές περιβάλλοντος -- Μην αποθηκεύετε ποτέ tokens ή διαπιστευτήρια στο αποθετήριο +- Ποτέ μην δεσμεύετε tokens ή διαπιστευτήρια -## Επιπλέον Σημειώσεις +## Πρόσθετες Σημειώσεις -### Στοχευόμενο Κοινό +### Στόχος Κοινού -- Απόλυτοι αρχάριοι στην ανάπτυξη ιστοσελίδων +- Αρχάριοι στην ανάπτυξη ιστού - Φοιτητές και αυτοδίδακτοι - Εκπαιδευτικοί που χρησιμοποιούν το πρόγραμμα σε τάξεις -- Το περιεχόμενο έχει σχεδιαστεί για προσβασιμότητα και σταδιακή ανάπτυξη δεξιοτήτων +- Το περιεχόμενο είναι σχεδιασμένο για προσβασιμότητα και σταδιακή ανάπτυξη δεξιοτήτων ### Εκπαιδευτική Φιλοσοφία -- Προσέγγιση μάθησης βασισμένη σε έργα -- Συχνές επαληθεύσεις γνώσεων (κουίζ) -- Πρακτικές ασκήσεις κωδικοποίησης +- Προσέγγιση μάθησης μέσω έργων +- Συχνές αξιολογήσεις γνώσης (κουίζ) +- Πρακτικές ασκήσεις κώδικα - Παραδείγματα εφαρμογών πραγματικού κόσμου -- Εστίαση στα βασικά πριν από τα frameworks +- Εστίαση στα θεμελιώδη πριν από τα πλαίσια εργασίας -### Διαχείριση Αποθετηρίου +### Συντήρηση Αποθετηρίου - Ενεργή κοινότητα μαθητών και συνεργατών - Τακτικές ενημερώσεις εξαρτήσεων και περιεχομένου - Παρακολούθηση θεμάτων και συζητήσεων από διαχειριστές -- Αυτόματες ενημερώσεις μεταφράσεων μέσω GitHub Actions +- Ενημερώσεις μεταφράσεων αυτοματοποιημένες μέσω GitHub Actions ### Σχετικοί Πόροι - [Microsoft Learn modules](https://docs.microsoft.com/learn/) -- [Student Hub πόροι](https://docs.microsoft.com/learn/student-hub/) -- Το [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) προτείνεται για μαθητές -- Επιπλέον μαθήματα: Generative AI, Data Science, ML, IoT curricula διαθέσιμα +- [Student Hub resources](https://docs.microsoft.com/learn/student-hub/) +- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) συνιστάται για μαθητές +- Πρόσθετα μαθήματα: Generative AI, Data Science, ML, IoT προγράμματα διαθέσιμα ### Εργασία με Συγκεκριμένα Έργα -Για λεπτομερείς οδηγίες για μεμονωμένα έργα, ανατρέξτε στα αρχεία README σε: -- `quiz-app/README.md` - Εφαρμογή κουίζ Vue 3 -- `7-bank-project/README.md` - Εφαρμογή τράπεζας με αυθεντικοποίηση -- `5-browser-extension/README.md` - Ανάπτυξη επέκτασης περιηγητή -- `6-space-game/README.md` - Ανάπτυξη παιχνιδιού καμβά +Για λεπτομερείς οδηγίες σε μεμονωμένα έργα, ανατρέξτε στα αρχεία README στα: +- `quiz-app/README.md` - Εφαρμογή κουίζ με Vue 3 +- `7-bank-project/README.md` - Τραπεζική εφαρμογή με πιστοποίηση +- `5-browser-extension/README.md` - Ανάπτυξη πρόσθετου περιηγητή +- `6-space-game/README.md` - Ανάπτυξη παιχνιδιού με Canvas - `9-chat-project/README.md` - Έργο βοηθού συνομιλίας AI ### Δομή Monorepo -Αν και δεν είναι παραδοσιακό monorepo, αυτό το αποθετήριο περιέχει πολλά ανεξάρτητα έργα: -- Κάθε μάθημα είναι ανεξάρτητο +Αν και δεν πρόκειται για παραδοσιακό monorepo, αυτό το αποθετήριο περιέχει πολλαπλά ανεξάρτητα έργα: +- Κάθε μάθημα είναι αυτοτελές - Τα έργα δεν μοιράζονται εξαρτήσεις -- Εργαστείτε σε μεμονωμένα έργα χωρίς να επηρεάσετε άλλα -- Κλωνοποιήστε ολόκληρο το αποθετήριο για την πλήρη εμπειρία προγράμματος σπουδών +- Εργασία σε μεμονωμένα έργα χωρίς να επηρεάζονται τα άλλα +- Κλωνοποιήστε ολόκληρο το αποθετήριο για πλήρη εμπειρία προγράμματος σπουδών --- -**Αποποίηση ευθύνης**: -Το παρόν έγγραφο έχει μεταφραστεί χρησιμοποιώντας την υπηρεσία αυτόματης μετάφρασης AI [Co-op Translator](https://github.com/Azure/co-op-translator). Παρόλο που επιδιώκουμε την ακρίβεια, παρακαλούμε να λάβετε υπόψη ότι οι αυτόματες μεταφράσεις ενδέχεται να περιέχουν λάθη ή ανακρίβειες. Το πρωτότυπο έγγραφο στη γλώσσα του θεωρείται η αυθεντική πηγή. Για κρίσιμες πληροφορίες, συνιστάται η επαγγελματική ανθρώπινη μετάφραση. Δεν φέρουμε καμία ευθύνη για τυχόν παρεξηγήσεις ή λανθασμένες ερμηνείες που προκύπτουν από τη χρήση αυτής της μετάφρασης. +**Αποποίηση ευθυνών**: +Αυτό το έγγραφο έχει μεταφραστεί χρησιμοποιώντας την υπηρεσία μετάφρασης AI [Co-op Translator](https://github.com/Azure/co-op-translator). Παρόλο που επιδιώκουμε την ακρίβεια, παρακαλούμε να γνωρίζετε ότι οι αυτοματοποιημένες μεταφράσεις ενδέχεται να περιέχουν σφάλματα ή ανακρίβειες. Το πρωτότυπο έγγραφο στη μητρική του γλώσσα θα πρέπει να θεωρείται η εγκυρότερη πηγή. Για κρίσιμες πληροφορίες, συνιστάται η επαγγελματική ανθρώπινη μετάφραση. Δεν φέρουμε καμία ευθύνη για τυχόν παρεξηγήσεις ή λανθασμένες ερμηνείες που προκύπτουν από τη χρήση αυτής της μετάφρασης. \ No newline at end of file diff --git a/translations/pl/.co-op-translator.json b/translations/pl/.co-op-translator.json index f4a3304ca..8fbe558b1 100644 --- a/translations/pl/.co-op-translator.json +++ b/translations/pl/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T08:40:42+00:00", + "translation_date": "2026-02-06T11:27:48+00:00", "source_file": "AGENTS.md", "language_code": "pl" }, diff --git a/translations/pl/AGENTS.md b/translations/pl/AGENTS.md index 5b393a98e..5e7844768 100644 --- a/translations/pl/AGENTS.md +++ b/translations/pl/AGENTS.md @@ -2,36 +2,36 @@ ## Przegląd projektu -To repozytorium z kursem edukacyjnym do nauczania podstaw tworzenia stron internetowych dla początkujących. Program nauczania to kompleksowy, 12-tygodniowy kurs stworzony przez Microsoft Cloud Advocates, zawierający 24 praktyczne lekcje obejmujące JavaScript, CSS i HTML. +To repozytorium kursu edukacyjnego do nauczania podstaw tworzenia stron internetowych dla początkujących. Program nauczania to kompleksowy 12-tygodniowy kurs opracowany przez Microsoft Cloud Advocates, zawierający 24 praktyczne lekcje obejmujące JavaScript, CSS i HTML. ### Kluczowe komponenty -- **Materiał edukacyjny**: 24 zorganizowane lekcje pogrupowane w moduły projektowe -- **Projekty praktyczne**: Terrarium, Gra na pisanie, Rozszerzenie przeglądarki, Gra kosmiczna, Aplikacja bankowa, Edytor kodu i Asystent czatu AI -- **Interaktywne quizy**: 48 quizów po 3 pytania każdy (oceny przed i po lekcji) -- **Wsparcie wielojęzyczne**: Automatyczne tłumaczenia na 50+ języków za pomocą GitHub Actions +- **Zawartość edukacyjna**: 24 uporządkowane lekcje zorganizowane w moduły projektowe +- **Praktyczne projekty**: Terrarium, Gra w pisanie na klawiaturze, Rozszerzenie przeglądarki, Gra kosmiczna, Aplikacja bankowa, Edytor kodu oraz Asystent czatu AI +- **Interaktywne quizy**: 48 quizów z 3 pytaniami każdy (oceny przed i po lekcji) +- **Wsparcie wielu języków**: Automatyczne tłumaczenia na ponad 50 języków za pomocą GitHub Actions - **Technologie**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (dla projektów AI) ### Architektura -- Edukacyjne repozytorium z strukturą opartą na lekcjach -- Każdy folder z lekcją zawiera README, przykłady kodu i rozwiązania -- Projekty samodzielne w osobnych katalogach (quiz-app, różne projekty lekcji) -- System tłumaczeń używający GitHub Actions (co-op-translator) -- Dokumentacja udostępniana przez Docsify i dostępna jako PDF +- Edukacyjne repozytorium o strukturze opartej na lekcjach +- Każdy folder lekcji zawiera plik README, przykłady kodu i rozwiązania +- Samodzielne projekty w osobnych katalogach (quiz-app, różne projekty lekcyjne) +- System tłumaczeń z wykorzystaniem GitHub Actions (co-op-translator) +- Dokumentacja udostępniana przez Docsify i dostępna w formacie PDF ## Komendy do konfiguracji -To repozytorium jest przeznaczone głównie do konsumpcji materiałów edukacyjnych. Aby pracować z konkretnymi projektami: +To repozytorium jest głównie do konsumpcji treści edukacyjnych. W przypadku pracy z konkretnymi projektami: -### Podstawowa konfiguracja repozytorium +### Główna konfiguracja repozytorium ```bash git clone https://github.com/microsoft/Web-Dev-For-Beginners.git cd Web-Dev-For-Beginners ``` -### Konfiguracja Quiz App (Vue 3 + Vite) +### Konfiguracja aplikacji quizowej (Vue 3 + Vite) ```bash cd quiz-app @@ -41,7 +41,7 @@ npm run build # Buduj do produkcji npm run lint # Uruchom ESLint ``` -### API projektu Bank +### API projektu bankowego (Node.js + Express) ```bash cd 7-bank-project/api @@ -51,7 +51,7 @@ npm run lint # Uruchom ESLint npm run format # Formatuj za pomocą Prettier ``` -### Projekty Rozszerzenia przeglądarki +### Projekty rozszerzeń przeglądarki ```bash cd 5-browser-extension/solution @@ -59,15 +59,15 @@ npm install # Postępuj zgodnie z instrukcjami ładowania rozszerzeń specyficznymi dla przeglądarki ``` -### Projekty Gry kosmicznej +### Projekty gry kosmicznej ```bash cd 6-space-game/solution npm install -# Otwórz index.html w przeglądarce lub użyj Live Servera +# Otwórz index.html w przeglądarce lub użyj Live Server ``` -### Projekt czatu (backend Python) +### Projekt czatu (Backend w Pythonie) ```bash cd 9-chat-project/solution/backend/python @@ -76,90 +76,90 @@ pip install openai python api.py ``` -## Przebieg pracy programistycznej +## Przebieg pracy deweloperskiej -### Dla osób dodających treści +### Dla współtwórców treści -1. **Utwórz fork repozytorium** na swoim koncie GitHub +1. **Zrób fork repozytorium** na swoje konto GitHub 2. **Sklonuj swój fork** lokalnie 3. **Utwórz nową gałąź** dla swoich zmian -4. Dokonaj zmian w treści lekcji lub przykładach kodu -5. Testuj zmiany w odpowiednich katalogach projektów -6. Złóż pull request zgodnie z wytycznymi dotyczącymi współpracy +4. Wprowadzaj zmiany w zawartości lekcji lub przykładach kodu +5. Testuj zmiany kodu w odpowiednich katalogach projektów +6. Zgłaszaj pull requesty zgodnie z wytycznymi dotyczącymi wkładu ### Dla uczących się 1. Zrób fork lub sklonuj repozytorium -2. Przechodź kolejno do folderów lekcji +2. Przechodź kolejno do katalogów z lekcjami 3. Czytaj pliki README dla każdej lekcji -4. Wypełnij quizy przed lekcją na https://ff-quizzes.netlify.app/web/ +4. Wypełniaj quizy przed lekcją na https://ff-quizzes.netlify.app/web/ 5. Pracuj nad przykładami kodu w folderach lekcji -6. Wykonuj zadania i wyzwania -7. Podejmij quizy po zakończeniu lekcji +6. Realizuj zadania i wyzwania +7. Wypełniaj quizy po lekcji -### Praca na żywo w trakcie rozwoju +### Rozwój na żywo - **Dokumentacja**: Uruchom `docsify serve` w katalogu głównym (port 3000) -- **Quiz App**: Uruchom `npm run dev` w katalogu quiz-app -- **Projekty**: Używaj rozszerzenia VS Code Live Server dla projektów HTML +- **Aplikacja quizowa**: Uruchom `npm run dev` w katalogu quiz-app +- **Projekty**: Użyj rozszerzenia VS Code Live Server dla projektów HTML - **Projekty API**: Uruchom `npm start` w odpowiednich katalogach API ## Instrukcje testowania -### Testowanie Quiz App +### Testowanie aplikacji quizowej ```bash cd quiz-app npm run lint # Sprawdź problemy ze stylem kodu -npm run build # Zweryfikuj, czy budowanie się powiodło +npm run build # Zweryfikuj, czy kompilacja zakończyła się sukcesem ``` -### Testowanie Bank API +### Testowanie API bankowego ```bash cd 7-bank-project/api -npm run lint # Sprawdź błędy stylu kodu +npm run lint # Sprawdź problemy ze stylem kodu node server.js # Zweryfikuj, czy serwer uruchamia się bez błędów ``` ### Ogólne podejście do testowania -- To repozytorium edukacyjne, bez kompleksowych testów automatycznych -- Testowanie manualne koncentruje się na: - - Poprawnym działaniu przykładów kodu bez błędów - - Prawidłowym działaniu linków w dokumentacji - - Pomyślnym przebiegu budowy projektów - - Przykładach zgodnych z najlepszymi praktykami +- To repozytorium edukacyjne bez kompleksowych zautomatyzowanych testów +- Testy manualne skupiają się na: + - poprawnym działaniu przykładów kodu bez błędów + - działaniu linków w dokumentacji + - poprawności kompilacji projektów + - stosowaniu najlepszych praktyk w przykładach -### Weryfikacja przed wysłaniem PR +### Kontrole przed przesłaniem - Uruchom `npm run lint` w katalogach z package.json - Sprawdź poprawność linków markdown - Testuj przykłady kodu w przeglądarce lub Node.js -- Sprawdź czy tłumaczenia zachowują poprawną strukturę +- Sprawdź, czy tłumaczenia zachowują odpowiednią strukturę ## Wytyczne dotyczące stylu kodu ### JavaScript - Używaj nowoczesnej składni ES6+ -- Stosuj konfiguracje ESLint dostępne w projektach -- Używaj znaczących nazw zmiennych i funkcji dla jasności edukacyjnej +- Stosuj standardowe konfiguracje ESLint dostarczone w projektach +- Używaj znaczących nazw zmiennych i funkcji dla klarowności edukacyjnej - Dodawaj komentarze wyjaśniające koncepcje dla uczących się -- Formatowanie za pomocą Prettier tam gdzie to skonfigurowano +- Formatowanie za pomocą Prettier tam, gdzie jest skonfigurowane ### HTML/CSS - Semantyczne elementy HTML5 - Zasady responsywnego projektowania -- Jasna konwencja nazewnictwa klas +- Jasne konwencje nazewnictwa klas - Komentarze wyjaśniające techniki CSS dla uczących się ### Python - Wytyczne stylu PEP 8 - Jasne, edukacyjne przykłady kodu -- Wskazówki typów tam, gdzie pomagają w uczeniu się +- Wskazówki typów tam, gdzie pomagają w nauce ### Dokumentacja Markdown @@ -167,33 +167,33 @@ node server.js # Zweryfikuj, czy serwer uruchamia się bez błędów - Bloki kodu ze specyfikacją języka - Linki do dodatkowych zasobów - Zrzuty ekranu i obrazy w katalogach `images/` -- Tekst alternatywny dla obrazów dla dostępności +- Tekst alternatywny dla obrazków dla dostępności ### Organizacja plików -- Lekcje ponumerowane kolejno (1-getting-started-lessons, 2-js-basics itd.) -- Każdy projekt ma katalog `solution/` i często `start/` lub `your-work/` -- Obrazy przechowywane w folderach lekcji `images/` -- Tłumaczenia w strukturze `translations/{language-code}/` +- Lekcje numerowane kolejno (1-getting-started-lessons, 2-js-basics itd.) +- Każdy projekt zawiera katalogi `solution/`, często też `start/` lub `your-work/` +- Obrazy przechowywane w folderach `images/` specyficznych dla lekcji +- Tłumaczenia w strukturze `translations/{kod-języka}/` ## Budowanie i wdrażanie -### Wdrażanie Quiz App (Azure Static Web Apps) +### Wdrażanie aplikacji quizowej (Azure Static Web Apps) -quiz-app jest skonfigurowany pod wdrożenie na Azure Static Web Apps: +Aplikacja quizowa jest skonfigurowana do wdrożenia na Azure Static Web Apps: ```bash cd quiz-app npm run build # Tworzy folder dist/ -# Wdraża za pomocą GitHub Actions workflow przy pushu do main +# Wdraża za pomocą workflow GitHub Actions przy pushu do main ``` Konfiguracja Azure Static Web Apps: - **Lokalizacja aplikacji**: `/quiz-app` -- **Lokalizacja wyjściowa**: `dist` +- **Lokalizacja wyjścia**: `dist` - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` -### Generowanie PDF dokumentacji +### Generowanie dokumentacji PDF ```bash npm install # Zainstaluj docsify-to-pdf @@ -209,74 +209,74 @@ docsify serve # Serwuj na localhost:3000 ### Budowy specyficzne dla projektów -Każdy katalog projektu może mieć własny proces budowania: -- Projekty Vue: `npm run build` tworzy bundlery produkcyjne -- Projekty statyczne: brak kroku kompilacji, pliki serwowane bezpośrednio +Każdy katalog projektu może mieć własny proces budowy: +- Projekty Vue: `npm run build` tworzy pakiety produkcyjne +- Projekty statyczne: brak kroku budowania, pliki serwowane bezpośrednio -## Zasady dotyczące pull requestów +## Wytyczne dotyczące pull requestów ### Format tytułu Używaj jasnych, opisowych tytułów wskazujących obszar zmian: -- `[Quiz-app] Dodaj nowy quiz do lekcji X` +- `[Quiz-app] Dodaj nowy quiz dla lekcji X` - `[Lesson-3] Popraw literówkę w projekcie terrarium` - `[Translation] Dodaj tłumaczenie na hiszpański dla lekcji 5` -- `[Docs] Aktualizuj instrukcje konfiguracji` +- `[Docs] Aktualizacja instrukcji konfiguracji` ### Wymagane kontrole -Przed złożeniem PR: +Przed przesłaniem PR: 1. **Jakość kodu**: - - Uruchom `npm run lint` w zmienionych katalogach projektów - - Napraw wszystkie błędy i ostrzeżenia lintingu + - Uruchom `npm run lint` w odpowiednich katalogach projektów + - Napraw wszystkie błędy i ostrzeżenia lint -2. **Weryfikacja budowy**: +2. **Weryfikacja budowania**: - Uruchom `npm run build` jeśli dotyczy - - Upewnij się, że nie ma błędów budowania + - Sprawdź brak błędów budowania 3. **Weryfikacja linków**: - Przetestuj wszystkie linki markdown - - Sprawdź, czy odwołania do obrazów działają + - Sprawdź działanie odwołań do obrazów 4. **Przegląd treści**: - - Korekta pod kątem ortografii i gramatyki - - Upewnij się, że przykłady kodu są poprawne i edukacyjne - - Zweryfikuj, że tłumaczenia zachowują oryginalne znaczenie + - Korekta pisowni i gramatyki + - Sprawdzenie poprawności i edukacyjnej wartości przykładów kodu + - Weryfikacja tłumaczeń pod kątem zachowania sensu oryginału -### Wymagania dotyczące wkładu +### Wymogi dotyczące wkładu -- Zgoda na Microsoft CLA (automatyczna weryfikacja przy pierwszym PR) +- Akceptacja Microsoft CLA (automatyczna weryfikacja przy pierwszym PR) - Przestrzeganie [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) - Szczegółowe wytyczne w [CONTRIBUTING.md](./CONTRIBUTING.md) -- Odniesienie numerów issue w opisie PR, jeśli dotyczy +- Wzmianka o numerach issue w opisie PR, jeśli dotyczy ### Proces przeglądu -- PR są przeglądane przez opiekunów i społeczność +- PR-y są przeglądane przez opiekunów i społeczność - Priorytetem jest jasność edukacyjna -- Przykłady kodu powinny stosować bieżące najlepsze praktyki -- Tłumaczenia weryfikowane pod kątem poprawności i dopasowania kulturowego +- Przykłady kodu powinny opierać się na aktualnych najlepszych praktykach +- Tłumaczenia poddawane weryfikacji pod kątem dokładności i odpowiedniości kulturowej ## System tłumaczeń ### Automatyczne tłumaczenie -- Wykorzystuje GitHub Actions z workflow co-op-translator -- Tłumaczy automatycznie na 50+ języków +- Wykorzystuje GitHub Actions ze workflow co-op-translator +- Tłumaczy automatycznie na ponad 50 języków - Pliki źródłowe w głównych katalogach -- Pliki tłumaczone w katalogach `translations/{language-code}/` +- Przetłumaczone pliki w katalogach `translations/{kod-języka}/` ### Dodawanie ręcznych poprawek tłumaczeń -1. Znajdź plik w `translations/{language-code}/` -2. Wprowadź poprawki z zachowaniem struktury +1. Znajdź plik w `translations/{kod-języka}/` +2. Wprowadź poprawki zachowując strukturę 3. Upewnij się, że przykłady kodu pozostają funkcjonalne -4. Przetestuj wszelkie lokalizowane treści quizów +4. Przetestuj zlokalizowaną zawartość quizów -### Metadane tłumaczenia +### Metadane tłumaczeń -Pliki tłumaczone zawierają nagłówek metadanych: +Przetłumaczone pliki zawierają nagłówek metadanych: ```markdown -**Zastrzeżenie**: -Niniejszy dokument został przetłumaczony przy użyciu automatycznego serwisu tłumaczeniowego AI [Co-op Translator](https://github.com/Azure/co-op-translator). Choć dokładamy starań, aby tłumaczenie było jak najbardziej precyzyjne, prosimy mieć na uwadze, że automatyczne tłumaczenia mogą zawierać błędy lub nieścisłości. Oryginalny dokument w języku źródłowym powinien być uznawany za źródło wiążące. W przypadku informacji krytycznych zalecane jest skorzystanie z profesjonalnego tłumaczenia wykonanego przez człowieka. Nie ponosimy odpowiedzialności za jakiekolwiek nieporozumienia lub błędne interpretacje wynikające z korzystania z tego tłumaczenia. +**Zastrzeżenie**: +Niniejszy dokument został przetłumaczony przy użyciu usługi tłumaczenia AI [Co-op Translator](https://github.com/Azure/co-op-translator). Mimo że staramy się o dokładność, prosimy pamiętać, że automatyczne tłumaczenia mogą zawierać błędy lub nieścisłości. Oryginalny dokument w jego języku źródłowym należy uważać za dokument autorytatywny. W przypadku informacji krytycznych zaleca się skorzystanie z profesjonalnego tłumaczenia wykonanego przez człowieka. Nie ponosimy odpowiedzialności za jakiekolwiek nieporozumienia lub błędne interpretacje wynikłe z użycia tego tłumaczenia. \ No newline at end of file diff --git a/translations/tr/.co-op-translator.json b/translations/tr/.co-op-translator.json index a522e3ad8..566d2aeca 100644 --- a/translations/tr/.co-op-translator.json +++ b/translations/tr/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T08:41:52+00:00", + "translation_date": "2026-02-06T11:28:53+00:00", "source_file": "AGENTS.md", "language_code": "tr" }, diff --git a/translations/tr/AGENTS.md b/translations/tr/AGENTS.md index a69d8ffa4..cf049b704 100644 --- a/translations/tr/AGENTS.md +++ b/translations/tr/AGENTS.md @@ -2,23 +2,23 @@ ## Proje Genel Bakışı -Bu, yeni başlayanlara web geliştirme temellerini öğretmek için hazırlanmış eğitim müfredatı deposudur. Müfredat, Microsoft Cloud Advocates tarafından geliştirilmiş kapsamlı 12 haftalık bir kurstur ve JavaScript, CSS ve HTML'i kapsayan 24 uygulamalı ders içerir. +Bu, başlangıç seviyesindekilere web geliştirme temellerini öğretmek için hazırlanmış bir eğitim müfredatı deposudur. Müfredat, Microsoft Cloud Advocates tarafından geliştirilen kapsamlı 12 haftalık bir ders programıdır ve JavaScript, CSS ve HTML'i kapsayan 24 uygulamalı dersten oluşmaktadır. -### Ana Bileşenler +### Temel Bileşenler -- **Eğitim İçeriği**: Proje tabanlı modüllerde düzenlenmiş 24 yapılandırılmış ders +- **Eğitim İçeriği**: Proje tabanlı modüllere organize edilmiş 24 yapılandırılmış ders - **Pratik Projeler**: Terrarium, Yazma Oyunu, Tarayıcı Uzantısı, Uzay Oyunu, Bankacılık Uygulaması, Kod Editörü ve AI Sohbet Asistanı -- **Etkileşimli Quizler**: Her biri 3 sorudan oluşan 48 quiz (ders öncesi/sonrası değerlendirmeler) -- **Çok Dilli Destek**: GitHub Actions ile 50+ dilde otomatik çeviriler +- **Etkileşimli Quizler**: Her biri 3 soruluk 48 quiz (ders öncesi/sonrası değerlendirmeler) +- **Çok Dilli Destek**: GitHub Actions ile 50+ dile otomatik çeviriler - **Teknolojiler**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI projeleri için) ### Mimari -- Ders tabanlı yapıya sahip eğitim deposu -- Her ders klasörü README, kod örnekleri ve çözümler içerir +- Ders bazlı yapıya sahip eğitim deposu +- Her ders klasöründe README, kod örnekleri ve çözümler bulunur - Bağımsız projeler ayrı dizinlerde (quiz-app, çeşitli ders projeleri) - GitHub Actions (co-op-translator) ile çeviri sistemi -- Docsify ile sunulan ve PDF olarak da erişilebilen dokümantasyon +- Docsify ile sunulan dokümantasyon ve PDF olarak erişilebilir ## Kurulum Komutları @@ -47,8 +47,8 @@ npm run lint # ESLint'i çalıştır cd 7-bank-project/api npm install npm start # API sunucusunu başlat -npm run lint # ESLint çalıştır -npm run format # Prettier ile formatla +npm run lint # ESLint'i çalıştır +npm run format # Prettier ile biçimlendir ``` ### Tarayıcı Uzantısı Projeleri @@ -67,42 +67,42 @@ npm install # index.html dosyasını tarayıcıda açın veya Canlı Sunucu kullanın ``` -### Sohbet Projesi (Python Arka Uç) +### Sohbet Projesi (Python Backend) ```bash cd 9-chat-project/solution/backend/python pip install openai -# GITHUB_TOKEN ortam değişkenini ayarla +# GITHUB_TOKEN ortam değişkenini ayarlayın python api.py ``` ## Geliştirme İş Akışı -### İçerik Katkı Sağlayıcıları için +### İçerik Katkıda Bulunanlar İçin 1. Depoyu GitHub hesabınıza **fork edin** -2. Kendi forkunuzu yerel olarak **klonlayın** -3. Değişiklikler için **yeni bir dal oluşturun** +2. Fork'unuzu lokal olarak **klonlayın** +3. Değişiklikleriniz için yeni bir **branch oluşturun** 4. Ders içeriği veya kod örneklerinde değişiklik yapın 5. İlgili proje dizinlerinde kod değişikliklerini test edin 6. Katkı kurallarına uygun şekilde pull request gönderin -### Öğrenenler için +### Öğrenenler İçin -1. Depoyu fork edin veya klonlayın -2. Ders dizinlerinde sırasıyla gezin -3. Her dersin README dosyasını okuyun -4. https://ff-quizzes.netlify.app/web/ adresinde ders öncesi quizleri tamamlayın -5. Ders klasörlerindeki kod örneklerinin üzerinden geçin +1. Depoyu fork edin ya da klonlayın +2. Ders dizinlerinde sırasıyla ilerleyin +3. Her ders için README dosyalarını okuyun +4. Ders öncesi quizlerini https://ff-quizzes.netlify.app/web/ adresinde tamamlayın +5. Ders klasörlerindeki kod örnekleri üzerinde çalışın 6. Ödevleri ve zorlukları tamamlayın -7. Ders sonrası quizleri yapın +7. Ders sonrası quizlerini çözün ### Canlı Geliştirme -- **Dokümantasyon**: Kök dizinde `docsify serve` komutunu çalıştırın (port 3000) -- **Quiz Uygulaması**: `quiz-app` dizininde `npm run dev` komutunu çalıştırın -- **Projeler**: HTML projeleri için VS Code Live Server uzantısını kullanın -- **API Projeleri**: İlgili API dizinlerinde `npm start` komutunu çalıştırın +- **Dokümantasyon**: Root dizinde `docsify serve` çalıştırın (port 3000) +- **Quiz Uygulaması**: quiz-app dizininde `npm run dev` çalıştırın +- **Projeler**: HTML projeleri için VS Code Live Server eklentisini kullanın +- **API Projeleri**: İlgili API dizinlerinde `npm start` çalıştırın ## Test Talimatları @@ -110,7 +110,7 @@ python api.py ```bash cd quiz-app -npm run lint # Kod stili sorunları için kontrol et +npm run lint # Kod stili sorunlarını kontrol et npm run build # Derlemenin başarılı olduğunu doğrula ``` @@ -124,159 +124,159 @@ node server.js # Sunucunun hatasız başlatıldığını doğrula ### Genel Test Yaklaşımı -- Bu bir eğitim deposudur ve kapsamlı otomatik testler içermez -- Manuel test şu noktalara odaklanır: - - Kod örneklerinin hata vermeden çalışması - - Dokümantasyondaki bağlantıların doğru çalışması - - Proje derlemelerinin başarılı tamamlanması - - Örneklerin en iyi uygulamaları takip etmesi +- Bu depo kapsamlı otomatik testler içermez +- Manuel test odakları: + - Kod örnekleri hatasız çalışmalı + - Dokümantasyon linkleri doğru çalışmalı + - Proje derlemeleri başarılı olmalı + - Örnekler en iyi uygulamaları takip etmeli ### Gönderim Öncesi Kontroller -- package.json içeren dizinlerde `npm run lint` komutunu çalıştırın -- Markdown bağlantılarının geçerliliğini doğrulayın -- Kod örneklerini tarayıcıda veya Node.js'te test edin -- Çevirilerin yapısal bütünlüğünü kontrol edin +- package.json içeren dizinlerde `npm run lint` çalıştırın +- Markdown linklerinin geçerli olduğunu doğrulayın +- Kod örneklerini tarayıcı veya Node.js’de test edin +- Çevirilerin yapısal bütünlüğü korunduğundan emin olun -## Kod Stili Kuralları +## Kod Stili Yönergeleri ### JavaScript - Modern ES6+ sözdizimi kullanın - Projelerde verilen standart ESLint yapılandırmalarına uyun -- Eğitsel açıklık için anlamlı değişken ve fonksiyon isimleri kullanın -- Öğrenenler için kavramları açıklayan yorumlar ekleyin -- Yapılandırılmış Prettier ile biçimlendirin +- Eğitim amaçlı anlamlı değişken ve fonksiyon isimleri tercih edin +- Kavramları açıklayan yorumlar ekleyin +- Prettier ile biçimlendirin (konfigüre edilen yerlerde) ### HTML/CSS -- Anlamsal HTML5 öğeleri -- Duyarlı tasarım prensipleri -- Açık sınıf isimlendirme kuralları +- Semantik HTML5 elementleri +- Responsive tasarım ilkeleri +- Anlaşılır sınıf isimlendirmeleri - Öğrenenler için CSS tekniklerini açıklayan yorumlar ### Python - PEP 8 stil kuralları -- Açık, eğitim amaçlı kod örnekleri -- Öğrenim için faydalı ise tip ipuçları +- Açık ve eğitim odaklı kod örnekleri +- Öğrenimi kolaylaştırmak için tip ipuçları -### Markdown Dokümantasyonu +### Markdown Dokümantasyon - Net başlık hiyerarşisi - Dil belirtilmiş kod blokları -- Ek kaynaklara bağlantılar -- `images/` klasörlerindeki ekran görüntüleri ve resimler -- Erişilebilirlik için görsellerde alt metin +- Ek kaynaklara yönlendiren linkler +- `images/` klasöründe ekran görüntüleri ve görseller +- Erişilebilirlik için resimler alt metinleri ### Dosya Organizasyonu -- Dersler numaralandırılmış sırasıyla (1-getting-started-lessons, 2-js-basics, vb.) +- Dersler numaralandırılmış (1-getting-started-lessons, 2-js-basics, vb.) - Her projenin `solution/` ve genellikle `start/` veya `your-work/` dizinleri var -- Resimler derslere özel `images/` klasörlerinde tutulur -- Çeviriler `translations/{language-code}/` yapısında +- Derslere özgü `images/` klasörlerinde görseller saklanır +- Çeviriler `translations/{language-code}/` dizin yapısında -## Derleme ve Dağıtım +## Derleme ve Yayınlama -### Quiz Uygulaması Dağıtımı (Azure Static Web Apps) +### Quiz Uygulaması Yayınlama (Azure Static Web Apps) -quiz-app, Azure Static Web Apps dağıtımı için yapılandırılmıştır: +Quiz-app, Azure Static Web Apps için yapılandırılmıştır: ```bash cd quiz-app npm run build # dist/ klasörü oluşturur -# main dalına push yapıldığında GitHub Actions iş akışı ile dağıtımı gerçekleştirir +# main'e push yapıldığında GitHub Actions iş akışı ile dağıtım yapar ``` -Azure Static Web Apps yapılandırması: -- **Uygulama konumu**: `/quiz-app` -- **Çıktı konumu**: `dist` +Azure Static Web Apps konfigürasyonu: +- **Uygulama dizini**: `/quiz-app` +- **Çıkış dizini**: `dist` - **İş akışı**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` ### Dokümantasyon PDF Oluşturma ```bash -npm install # docsify-to-pdf yükle -npm run convert # Docs'dan PDF oluştur +npm install # Docsify-to-pdf yükle +npm run convert # Docs'tan PDF oluştur ``` -### Docsify Dokümantasyonu +### Docsify Dokümantasyon ```bash -npm install -g docsify-cli # Docsify'ı global olarak yükleyin -docsify serve # localhost:3000 üzerinde hizmet verin +npm install -g docsify-cli # Docsify'yi global olarak yükleyin +docsify serve # localhost:3000 üzerinde servis verin ``` -### Proje Bazlı Derlemeler +### Proje Özel Derleme Her proje dizininin kendi derleme süreci olabilir: - Vue projeleri: `npm run build` ile üretim paketleri oluşturur - Statik projeler: Derleme adımı yok, dosyalar doğrudan sunulur -## Pull Request Kuralları +## Pull Request (PR) Yönergeleri ### Başlık Formatı -Değişiklik alanını belirten net, açıklayıcı başlıklar kullanın: +Değişiklik alanını net belirten açıklayıcı başlıklar kullanın: - `[Quiz-app] Ders X için yeni quiz ekle` -- `[Lesson-3] Terrarium projesinde yazım hatasını düzelt` -- `[Translation] Ders 5 için İspanyolca çeviri ekle` +- `[Lesson-3] Terrarium projesinde yazım hatası düzelt` +- `[Translation] Ders 5 İspanyolca çevirisi ekle` - `[Docs] Kurulum talimatlarını güncelle` -### Gereken Kontroller +### Gerekli Kontroller PR göndermeden önce: 1. **Kod Kalitesi**: - - Etkilenen proje dizinlerinde `npm run lint`i çalıştırın - - Tüm lint hatalarını ve uyarılarını düzeltin + - Etkilenen projelerde `npm run lint` çalıştırın + - Tüm hata ve uyarıları giderin -2. **Derleme Doğrulaması**: - - Geçerliyse `npm run build` komutunu çalıştırın +2. **Derleme Doğrulama**: + - Uygunsa `npm run build` yapın - Derleme hatası olmadığından emin olun -3. **Bağlantı Kontrolü**: - - Tüm markdown bağlantılarını test edin - - Resim referanslarının çalıştığını doğrulayın +3. **Link Doğrulama**: + - Tüm markdown linklerini test edin + - Görsel referanslarının çalıştığını kontrol edin 4. **İçerik İncelemesi**: - - Yazım ve dilbilgisi kontrolü yapın - - Kod örneklerinin doğru ve eğitsel olduğundan emin olun - - Çevirilerin orijinal anlamı koruduğunu onaylayın + - Yazım ve dilbilgisi denetimi yapın + - Kod örneklerinin doğru ve öğretici olduğunu teyit edin + - Çevirilerin anlam bütünlüğünü koruduğundan emin olun -### Katkı Koşulları +### Katkı Gereksinimleri - Microsoft CLA onaylayın (ilk PR’de otomatik kontrol) -- [Microsoft Açık Kaynak Davranış Kuralları](https://opensource.microsoft.com/codeofconduct/)na uyun -- Ayrıntılı kurallar için [CONTRIBUTING.md](./CONTRIBUTING.md) dosyasına bakın -- Gerekirse PR açıklamasına ilgili issue numaralarını ekleyin +- [Microsoft Açık Kaynak Davranış Kurallarına](https://opensource.microsoft.com/codeofconduct/) uyun +- Ayrıntılar için [CONTRIBUTING.md](./CONTRIBUTING.md) dosyasını inceleyin +- Varsa PR açıklamasında ilgili issue numaralarını referans gösterin ### İnceleme Süreci - PR’lar bakımcılar ve topluluk tarafından incelenir -- Eğitsel açıklık önceliklidir -- Kod örnekleri güncel en iyi uygulamalara uygun olmalıdır +- Eğitimsel netliğe öncelik verilir +- Kod örnekleri güncel en iyi uygulamalara uygun olmalı - Çeviriler doğruluk ve kültürel uygunluk açısından değerlendirilir ## Çeviri Sistemi ### Otomatik Çeviri -- co-op-translator iş akışı ile GitHub Actions kullanılır +- GitHub Actions ile co-op-translator iş akışı kullanılır - 50+ dile otomatik çeviri yapılır - Kaynak dosyalar ana dizinlerde -- Çevirilen dosyalar `translations/{language-code}/` dizinlerinde +- Çevrilmiş dosyalar `translations/{language-code}/` klasörlerinde ### Manuel Çeviri İyileştirmeleri Ekleme -1. `translations/{language-code}/` dizininde dosyayı bulun +1. `translations/{language-code}/` içindeki dosyayı bulun 2. Yapıyı koruyarak iyileştirmeler yapın -3. Kod örneklerinin işlevselliğinin devam ettiğinden emin olun -4. Yerelleştirilmiş quiz içeriğini test edin +3. Kod örneklerinin çalışmaya devam ettiğinden emin olun +4. Yerelleştirilmiş quiz içeriklerini test edin -### Çeviri Meta Verileri +### Çeviri Meta Verisi -Çevrilmiş dosyalarda meta veri başlığı bulunur: +Çevrilmiş dosyalar meta veri başlığı içerir: ```markdown -**Feragatname**: -Bu belge, AI çeviri servisi [Co-op Translator](https://github.com/Azure/co-op-translator) kullanılarak çevrilmiştir. Doğruluk için çaba göstersek de, otomatik çevirilerin hata veya yanlışlık içerebileceğini lütfen unutmayın. Orijinal belgenin kendi dili, yetkili kaynak olarak kabul edilmelidir. Kritik bilgiler için profesyonel insan çevirisi önerilir. Bu çevirinin kullanımı nedeniyle ortaya çıkabilecek yanlış anlamalar veya yorum hatalarından sorumlu tutulamayız. +**Feragatname**: +Bu belge, AI çeviri servisi [Co-op Translator](https://github.com/Azure/co-op-translator) kullanılarak çevrilmiştir. Doğruluk için çaba göstersek de, otomatik çevirilerde hatalar veya yanlışlıklar olabileceğini lütfen unutmayınız. Orijinal belge, kendi dilinde yetkili kaynak olarak kabul edilmelidir. Kritik bilgiler için profesyonel insan çevirisi önerilir. Bu çevirinin kullanımından kaynaklanan herhangi bir yanlış anlama veya yanlış yorumlamadan sorumlu değiliz. \ No newline at end of file