diff --git a/translations/el/.co-op-translator.json b/translations/el/.co-op-translator.json index d500ac56e..dcfc492cd 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-06T11:30:21+00:00", + "translation_date": "2026-02-06T12:56:51+00:00", "source_file": "AGENTS.md", "language_code": "el" }, diff --git a/translations/el/AGENTS.md b/translations/el/AGENTS.md index 2ab9a7bb4..cf98a4824 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 -- **Διαδραστικά Κουίζ**: 48 κουίζ με 3 ερωτήσεις το καθένα (αξιολογήσεις πριν και μετά το μάθημα) +- **Εκπαιδευτικό Περιεχόμενο**: 24 δομημένα μαθήματα οργανωμένα σε μονάδες με βάση έργα +- **Πρακτικά Έργα**: Terrarium, Παιχνίδι Πληκτρολόγησης, Επέκταση Περιηγητή, Παιχνίδι Διαστήματος, Εφαρμογή Τράπεζας, Κώδικας Επεξεργαστής, και Βοηθός Συνομιλίας AI +- **Διαδραστικά Κουίζ**: 48 κουίζ με 3 ερωτήσεις το καθένα (προ- / μετά-μάθημα αξιολογήσεις) - **Υποστήριξη Πολλών Γλωσσών**: Αυτόματες μεταφράσεις σε 50+ γλώσσες μέσω GitHub Actions - **Τεχνολογίες**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (για έργα AI) ### Αρχιτεκτονική -- Εκπαιδευτικό αποθετήριο με δομή βασισμένη στα μαθήματα +- Εκπαιδευτικό αποθετήριο με δομή βασισμένη σε μαθήματα - Κάθε φάκελος μαθήματος περιέχει README, παραδείγματα κώδικα και λύσεις -- Αυτόνομα έργα σε ξεχωριστά καταλόγους (quiz-app, διάφορα έργα μαθημάτων) +- Ανεξάρτητα έργα σε ξεχωριστούς φακέλους (quiz-app, διάφορα έργα μαθημάτων) - Σύστημα μετάφρασης με χρήση GitHub Actions (co-op-translator) -- Τεκμηρίωση εξυπηρετείται μέσω Docsify και είναι διαθέσιμη και σε PDF +- Τεκμηρίωση που σερβίρεται μέσω Docsify και διατίθεται σε PDF -## Εντολές Ρύθμισης +## Εντολές Ρυθμίσεων -Αυτό το αποθετήριο είναι κυρίως για κατανάλωση εκπαιδευτικού περιεχομένου. Για εργασία με συγκεκριμένα έργα: +Αυτό το αποθετήριο προορίζεται κυρίως για κατανάλωση εκπαιδευτικού περιεχομένου. Για εργασία με συγκεκριμένα έργα: ### Ρύθμιση Κύριου Αποθετηρίου @@ -31,12 +31,12 @@ git clone https://github.com/microsoft/Web-Dev-For-Beginners.git cd Web-Dev-For-Beginners ``` -### Ρύθμιση Quiz App (Vue 3 + Vite) +### Ρύθμιση Εφαρμογής Κουίζ (Vue 3 + Vite) ```bash cd quiz-app npm install -npm run dev # Εκκίνηση διακομιστή ανάπτυξης +npm run dev # Ξεκινήστε τον διακομιστή ανάπτυξης npm run build # Δημιουργία για παραγωγή npm run lint # Εκτέλεση ESLint ``` @@ -51,12 +51,12 @@ npm run lint # Εκτέλεση ESLint npm run format # Μορφοποίηση με Prettier ``` -### Έργα Πρόσθετων Περιηγητή +### Έργα Επέκτασης Περιηγητή ```bash cd 5-browser-extension/solution npm install -# Ακολουθήστε τις οδηγίες φόρτωσης επεκτάσεων ανά πρόγραμμα περιήγησης +# Ακολουθήστε τις οδηγίες φόρτωσης επεκτάσεων ειδικές για τον περιηγητή ``` ### Έργα Παιχνιδιού Διαστήματος @@ -78,126 +78,126 @@ python api.py ## Ροή Ανάπτυξης -### Για Συνεργάτες Περιεχομένου +### Για Συνεισφέροντες Περιεχομένου -1. **Κάντε fork το αποθετήριο** στον λογαριασμό σας στο GitHub +1. **Δημιουργήστε fork** του αποθετηρίου στον λογαριασμό σας στο GitHub 2. **Κλωνοποιήστε το fork** τοπικά 3. **Δημιουργήστε νέο branch** για τις αλλαγές σας 4. Κάντε αλλαγές στο περιεχόμενο των μαθημάτων ή στα παραδείγματα κώδικα -5. Δοκιμάστε τις αλλαγές σε κώδικα στους σχετικούς φακέλους έργων +5. Δοκιμάστε τις όποιες αλλαγές κώδικα στους αντίστοιχους φακέλους έργων 6. Υποβάλετε pull requests ακολουθώντας τις οδηγίες συνεισφοράς ### Για Μαθητές -1. Κάντε fork ή κλώνο του αποθετηρίου -2. Μεταβείτε στους φακέλους μαθημάτων σειριακά -3. Διαβάστε τα αρχεία README για κάθε μάθημα -4. Ολοκληρώστε τα προκαταρκτικά κουίζ στο https://ff-quizzes.netlify.app/web/ -5. Δουλέψτε με τα παραδείγματα κώδικα στους φακέλους μαθημάτων +1. Κάντε fork ή κλωνοποιήστε το αποθετήριο +2. Περιηγηθείτε στους φακέλους μαθημάτων με τη σειρά +3. Διαβάστε τα αρχεία README κάθε μαθήματος +4. Ολοκληρώστε τα προ-μάθημα κουίζ στο https://ff-quizzes.netlify.app/web/ +5. Εργαστείτε με τα παραδείγματα κώδικα στους φακέλους μαθημάτων 6. Ολοκληρώστε εργασίες και προκλήσεις -7. Πραγματοποιήστε τα μετα-μαθηματικά κουίζ +7. Κάντε τα κουίζ μετά το μάθημα ### Ζωντανή Ανάπτυξη -- **Τεκμηρίωση**: Εκτελέστε `docsify serve` στον ριζικό φάκελο (θύρα 3000) -- **Quiz App**: Εκτελέστε `npm run dev` στον φάκελο quiz-app -- **Έργα**: Χρησιμοποιήστε την επέκταση Live Server του VS Code για έργα HTML -- **API Έργα**: Εκτελέστε `npm start` στους αντίστοιχους φακέλους API +- **Τεκμηρίωση**: Τρέξτε `docsify serve` από τον ριζικό φάκελο (θύρα 3000) +- **Εφαρμογή Κουίζ**: Τρέξτε `npm run dev` στον φάκελο quiz-app +- **Έργα**: Χρησιμοποιήστε το VS Code Live Server extension για τα έργα HTML +- **API Έργα**: Τρέξτε `npm start` στους αντίστοιχους φακέλους API ## Οδηγίες Δοκιμών -### Δοκιμή Quiz App +### Δοκιμή Εφαρμογής Κουίζ ```bash cd quiz-app -npm run lint # Ελέγξτε για ζητήματα στυλ κώδικα -npm run build # Επαληθεύστε ότι η κατασκευή είναι επιτυχής +npm run lint # Ελέγξτε για προβλήματα στυλ κώδικα +npm run build # Επιβεβαιώστε ότι η κατασκευή πετυχαίνει ``` -### Δοκιμή Bank API +### Δοκιμή API Τράπεζας ```bash cd 7-bank-project/api -npm run lint # Έλεγχος για προβλήματα στο στυλ κώδικα -node server.js # Επιβεβαίωση ότι ο διακομιστής ξεκινά χωρίς σφάλματα +npm run lint # Ελέγξτε για ζητήματα στυλ κώδικα +node server.js # Επαληθεύστε ότι ο διακομιστής ξεκινά χωρίς σφάλματα ``` ### Γενική Προσέγγιση Δοκιμών -- Αυτό είναι ένα εκπαιδευτικό αποθετήριο χωρίς ολοκληρωμένες αυτοματοποιημένες δοκιμές -- Οι χειροκίνητες δοκιμές εστιάζουν στα: - - Παραδείγματα κώδικα να εκτελούνται χωρίς σφάλματα - - Οι σύνδεσμοι στην τεκμηρίωση να λειτουργούν σωστά - - Οι κατασκευές έργων να ολοκληρώνονται επιτυχώς - - Τα παραδείγματα να ακολουθούν βέλτιστες πρακτικές +- Πρόκειται για εκπαιδευτικό αποθετήριο χωρίς πλήρεις αυτοματοποιημένες δοκιμές +- Οι χειροκίνητες δοκιμές εστιάζουν σε: + - Εκτέλεση παραδειγμάτων κώδικα χωρίς σφάλματα + - Σωστή λειτουργία συνδέσμων στην τεκμηρίωση + - Επιτυχημένη ολοκλήρωση build έργων + - Τα παραδείγματα να ακολουθούν τις βέλτιστες πρακτικές ### Έλεγχοι Πριν την Υποβολή -- Εκτελέστε `npm run lint` σε φακέλους με package.json +- Τρέξτε `npm run lint` στους φακέλους με package.json - Επαληθεύστε ότι οι σύνδεσμοι markdown είναι έγκυροι -- Δοκιμάστε παραδείγματα κώδικα σε περιηγητή ή Node.js -- Βεβαιωθείτε ότι οι μεταφράσεις διατηρούν την κατάλληλη δομή +- Δοκιμάστε τα παραδείγματα κώδικα στον περιηγητή ή Node.js +- Ελέγξτε ότι οι μεταφράσεις διατηρούν σωστή δομή ## Οδηγίες Στυλ Κώδικα ### JavaScript -- Χρησιμοποιήστε σύγχρονη σύνταξη ES6+ +- Χρήση σύγχρονης σύνταξης ES6+ - Ακολουθήστε τις τυπικές ρυθμίσεις ESLint που παρέχονται στα έργα -- Χρησιμοποιήστε σημασιολογικά ονόματα μεταβλητών και συναρτήσεων για εκπαιδευτική σαφήνεια -- Προσθέστε σχόλια που εξηγούν έννοιες για τους μαθητές -- Μορφοποιήστε με Prettier όπου είναι ρυθμισμένο +- Χρήση περιγραφικών ονομάτων μεταβλητών και συναρτήσεων για εκπαιδευτική σαφήνεια +- Προσθήκη σχολίων που εξηγούν έννοιες για τους μαθητές +- Μορφοποίηση με Prettier όπου είναι ρυθμισμένο ### HTML/CSS -- Σημασιολογικά στοιχεία HTML5 -- Αρχές σχεδιασμού με ανταπόκριση -- Καθαρή ονοματολογία κλάσεων +- Σημαντικά στοιχεία HTML5 +- Αρχές σχεδίασης responsive +- Σαφής ονοματοδοσία τάξεων - Σχόλια που εξηγούν τεχνικές CSS για τους μαθητές ### Python - Οδηγίες στυλ PEP 8 - Καθαρά, εκπαιδευτικά παραδείγματα κώδικα -- Υποδείξεις τύπων όπου βοηθούν στη μάθηση +- Τυπολογικές υποδείξεις όπου είναι χρήσιμες για μάθηση ### Τεκμηρίωση Markdown -- Σαφής ιεραρχία επικεφαλίδων -- Μπλοκ κώδικα με καθορισμό γλώσσας -- Σύνδεσμοι προς πρόσθετους πόρους +- Καθαρή ιεραρχία επικεφαλίδων +- Κώδικας με καθορισμένη γλώσσα +- Σύνδεσμοι προς επιπλέον πόρους - Στιγμιότυπα και εικόνες στους φακέλους `images/` -- Κείμενο alt για τις εικόνες για προσβασιμότητα +- Εναλλακτικό κείμενο για εικόνες για προσβασιμότητα ### Οργάνωση Αρχείων -- Μαθήματα αριθμημένα διαδοχικά (1-getting-started-lessons, 2-js-basics, κλπ.) +- Μαθήματα αριθμημένα διαδοχικά (1-getting-started-lessons, 2-js-basics, κ.λπ.) - Κάθε έργο έχει φακέλους `solution/` και συχνά `start/` ή `your-work/` - Εικόνες αποθηκευμένες σε φακέλους `images/` ειδικούς για κάθε μάθημα -- Μεταφράσεις σε διάταξη `translations/{language-code}/` +- Μεταφράσεις σε φάκελο `translations/{language-code}/` ## Κατασκευή και Ανάπτυξη -### Ανάπτυξη Quiz App (Azure Static Web Apps) +### Ανάπτυξη Εφαρμογής Κουίζ (Azure Static Web Apps) -Το quiz-app είναι ρυθμισμένο για ανάπτυξη σε Azure Static Web Apps: +Η εφαρμογή κουίζ είναι διαμορφωμένη για ανάπτυξη σε Azure Static Web Apps: ```bash cd quiz-app -npm run build # Δημιουργεί το φάκελο dist/ -# Αναπτύσσει μέσω της ροής εργασίας GitHub Actions κατά την ώθηση στο main +npm run build # Δημιουργεί τον φάκελο dist/ +# Αναπτύσσει μέσω της ροής εργασίας GitHub Actions κατά την αποστολή στην κύρια ветка ``` -Ρυθμίσεις 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 από τα έγγραφα +npm install # Εγκατάσταση docsify-to-pdf +npm run convert # Δημιουργία PDF από docs ``` ### Τεκμηρίωση Docsify @@ -207,76 +207,76 @@ npm install -g docsify-cli # Εγκαταστήστε το Docsify παγκο docsify serve # Εξυπηρετήστε στο localhost:3000 ``` -### Κατασκευές ειδικές για έργο +### Κατασκευές ανά Έργο -Κάθε φάκελος έργου μπορεί να έχει τη δική του διαδικασία κατασκευής: -- Έργα Vue: `npm run build` δημιουργεί παραγωγικά πακέτα -- Στατικά έργα: Δεν υπάρχει βήμα κατασκευής, εξυπηρετούνται τα αρχεία απευθείας +Κάθε φάκελος έργου μπορεί να έχει τη δική του διαδικασία: +- Έργα Vue: `npm run build` δημιουργεί πακέτα παραγωγής +- Στατικά έργα: Δεν υπάρχει βήμα build, σερβίρονται απευθείας τα αρχεία ## Οδηγίες Pull Request -### Μορφοποίηση Τίτλου +### Μορφή Τίτλου -Χρησιμοποιήστε σαφείς, περιγραφικούς τίτλους που υποδεικνύουν τον τομέα αλλαγής: +Χρησιμοποιήστε σαφείς, περιγραφικούς τίτλους που δηλώνουν την περιοχή αλλαγής: - `[Quiz-app] Προσθήκη νέου κουίζ για μάθημα Χ` -- `[Lesson-3] Διόρθωση ορθογραφικού λάθους στο έργο terrarium` -- `[Translation] Προσθήκη ισπανικής μετάφρασης για μάθημα 5` -- `[Docs] Ενημέρωση οδηγιών ρύθμισης` +- `[Lesson-3] Διόρθωση ορθογραφικού στο έργο terrarium` +- `[Translation] Προσθήκη μετάφρασης στα Ισπανικά για μάθημα 5` +- `[Docs] Ενημέρωση οδηγιών εγκατάστασης` -### Απαραίτητοι Έλεγχοι +### Απαιτούμενοι Έλεγχοι Πριν την υποβολή PR: 1. **Ποιότητα Κώδικα**: - - Εκτελέστε `npm run lint` στους σχετικούς φακέλους έργων - - Διορθώστε όλα τα σφάλματα και προειδοποιήσεις lint + - Τρέξτε `npm run lint` στους επηρεαζόμενους φακέλους έργων + - Διορθώστε όλα τα σφάλματα και τις προειδοποιήσεις lint -2. **Επαλήθευση Κατασκευής**: - - Εκτελέστε `npm run build` αν εφαρμόζεται - - Βεβαιωθείτε ότι δεν υπάρχουν σφάλματα κατασκευής +2. **Επαλήθευση Build**: + - Τρέξτε `npm run build` αν αφορά + - Εξασφαλίστε ότι δεν υπάρχουν σφάλματα build -3. **Επαλήθευση Συνδέσμων**: +3. **Επικύρωση Συνδέσμων**: - Δοκιμάστε όλους τους συνδέσμους markdown - - Επαληθεύστε ότι οι αναφορές εικόνων λειτουργούν + - Επαληθεύστε σωστή λειτουργία αναφορών εικόνων -4. **Έλεγχος Περιεχομένου**: - - Διορθώστε ορθογραφία και γραμματική +4. **Ανασκόπηση Περιεχομένου**: + - Διορθώστε ορθογραφικά και γραμματικά λάθη - Βεβαιωθείτε ότι τα παραδείγματα κώδικα είναι σωστά και εκπαιδευτικά - - Επιβεβαιώστε ότι οι μεταφράσεις διατηρούν την αρχική έννοια + - Ελέγξτε ότι οι μεταφράσεις διατηρούν το πρωτότυπο νόημα ### Απαιτήσεις Συνεισφοράς -- Αποδοχή Microsoft CLA (αυτόματος έλεγχος στην πρώτη PR) -- Ακολουθήστε τον [Κώδικα Συμπεριφοράς Ανοιχτού Κώδικα Microsoft](https://opensource.microsoft.com/codeofconduct/) -- Δείτε το [CONTRIBUTING.md](./CONTRIBUTING.md) για λεπτομερείς οδηγίες -- Αναφέρετε τους αριθμούς θεμάτων στην περιγραφή PR αν ισχύει +- Αποδοχή του Microsoft CLA (αυτόματος έλεγχος στο πρώτο PR) +- Τήρηση του [Κώδικα Δεοντολογίας Microsoft Open Source](https://opensource.microsoft.com/codeofconduct/) +- Δείτε το [CONTRIBUTING.md](./CONTRIBUTING.md) για αναλυτικές οδηγίες +- Αναφορά αριθμών ζητημάτων στην περιγραφή PR αν ισχύει -### Διαδικασία Επισκόπησης +### Διαδικασία Αναθεώρησης -- Οι PR ελέγχονται από διαχειριστές και κοινότητα +- Τα PR ελέγχονται από διαχειριστές και την κοινότητα - Προτεραιότητα στην εκπαιδευτική σαφήνεια -- Τα παραδείγματα κώδικα να ακολουθούν τις τρέχουσες βέλτιστες πρακτικές -- Οι μεταφράσεις ελέγχονται για ακρίβεια και πολιτισμική καταλληλότητα +- Παραδείγματα κώδικα να ακολουθούν τις τρέχουσες βέλτιστες πρακτικές +- Μεταφράσεις ελέγχονται για ακρίβεια και πολιτισμική καταλληλότητα ## Σύστημα Μετάφρασης ### Αυτόματη Μετάφραση -- Χρησιμοποιεί GitHub Actions με ροή εργασίας co-op-translator -- Μεταφράζει σε 50+ γλώσσες αυτόματα +- Χρήση GitHub Actions με ροή εργασίας co-op-translator +- Μεταφράζει αυτόματα σε 50+ γλώσσες - Αρχεία πηγής στους κύριους φακέλους -- Μεταφρασμένα αρχεία στους φακέλους `translations/{language-code}/` +- Μεταφρασμένα αρχεία σε φακέλους `translations/{language-code}/` ### Προσθήκη Χειροκίνητων Βελτιώσεων Μετάφρασης -1. Εντοπίστε αρχείο στο `translations/{language-code}/` +1. Εντοπίστε αρχείο σε `translations/{language-code}/` 2. Κάντε βελτιώσεις διατηρώντας τη δομή -3. Βεβαιωθείτε ότι τα παραδείγματα κώδικα παραμένουν λειτουργικά +3. Εξασφαλίστε τη λειτουργικότητα παραδειγμάτων κώδικα 4. Δοκιμάστε τυχόν τοπικοποιημένο περιεχόμενο κουίζ ### Μεταδεδομένα Μετάφρασης -Τα μεταφρασμένα αρχεία περιλαμβάνουν επικεφαλίδα μεταδεδομένων: +Τα μεταφρασμένα αρχεία περιλαμβάνουν κεφαλίδα μεταδεδομένων: ```markdown **Αποποίηση ευθυνών**: -Αυτό το έγγραφο έχει μεταφραστεί χρησιμοποιώντας την υπηρεσία μετάφρασης 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 8fbe558b1..2301c53af 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-06T11:27:48+00:00", + "translation_date": "2026-02-06T12:54:14+00:00", "source_file": "AGENTS.md", "language_code": "pl" }, diff --git a/translations/pl/AGENTS.md b/translations/pl/AGENTS.md index 5e7844768..a66628ddf 100644 --- a/translations/pl/AGENTS.md +++ b/translations/pl/AGENTS.md @@ -2,27 +2,27 @@ ## Przegląd projektu -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. +To jest repozytorium programu 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 +### Kluczowe elementy -- **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 +- **Treści edukacyjne**: 24 uporządkowane lekcje zorganizowane w moduły oparte na projektach +- **Praktyczne projekty**: Terrarium, Gra w 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 - **Technologie**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (dla projektów AI) ### Architektura -- 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 +- Repozytorium edukacyjne o strukturze lekcji +- Każdy folder lekcji zawiera README, przykłady kodu i rozwiązania +- Projekty samodzielne w osobnych katalogach (quiz-app, różne projekty lekcji) +- System tłumaczeń wykorzystujący GitHub Actions (co-op-translator) +- Dokumentacja udostępniana przez Docsify oraz dostępna jako PDF -## Komendy do konfiguracji +## Polecenia konfiguracji -To repozytorium jest głównie do konsumpcji treści edukacyjnych. W przypadku pracy z konkretnymi projektami: +To repozytorium służy głównie do konsumpcji treści edukacyjnych. Aby pracować z konkretnymi projektami: ### Główna konfiguracja repozytorium @@ -37,7 +37,7 @@ cd Web-Dev-For-Beginners cd quiz-app npm install npm run dev # Uruchom serwer deweloperski -npm run build # Buduj do produkcji +npm run build # Zbuduj wersję produkcyjną npm run lint # Uruchom ESLint ``` @@ -48,7 +48,7 @@ cd 7-bank-project/api npm install npm start # Uruchom serwer API npm run lint # Uruchom ESLint -npm run format # Formatuj za pomocą Prettier +npm run format # Sformatuj za pomocą Prettier ``` ### Projekty rozszerzeń przeglądarki @@ -67,7 +67,7 @@ npm install # Otwórz index.html w przeglądarce lub użyj Live Server ``` -### Projekt czatu (Backend w Pythonie) +### Projekt czatu (backend w Pythonie) ```bash cd 9-chat-project/solution/backend/python @@ -76,28 +76,28 @@ pip install openai python api.py ``` -## Przebieg pracy deweloperskiej +## Przepływ pracy podczas rozwoju ### Dla współtwórców treści -1. **Zrób fork repozytorium** na swoje konto GitHub -2. **Sklonuj swój fork** lokalnie -3. **Utwórz nową gałąź** dla swoich zmian -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 +1. **Utwórz fork repozytorium** na swoim koncie GitHub +2. **Sklonuj swoje fork** lokalnie +3. **Utwórz nową gałąź** na swoje zmiany +4. Dokonaj zmian w treści lekcji lub przykładach kodu +5. Przetestuj zmiany kodu w odpowiednich katalogach projektów +6. Prześlij pull request według wytycznych dotyczących wkładu ### Dla uczących się -1. Zrób fork lub sklonuj repozytorium -2. Przechodź kolejno do katalogów z lekcjami +1. Forkuj lub klonuj repozytorium +2. Przechodź sekwencyjnie do katalogów lekcji 3. Czytaj pliki README dla każdej lekcji -4. Wypełniaj quizy przed lekcją na https://ff-quizzes.netlify.app/web/ -5. Pracuj nad przykładami kodu w folderach lekcji -6. Realizuj zadania i wyzwania -7. Wypełniaj quizy po lekcji +4. Wykonaj quizy przed lekcją na https://ff-quizzes.netlify.app/web/ +5. Pracuj z przykładami kodu w folderach lekcji +6. Wykonaj zadania i wyzwania +7. Przystąp do quizów po lekcji -### Rozwój na żywo +### Programowanie na żywo - **Dokumentacja**: Uruchom `docsify serve` w katalogu głównym (port 3000) - **Aplikacja quizowa**: Uruchom `npm run dev` w katalogu quiz-app @@ -111,10 +111,10 @@ python api.py ```bash cd quiz-app npm run lint # Sprawdź problemy ze stylem kodu -npm run build # Zweryfikuj, czy kompilacja zakończyła się sukcesem +npm run build # Zweryfikuj powodzenie kompilacji ``` -### Testowanie API bankowego +### Testowanie API banku ```bash cd 7-bank-project/api @@ -124,34 +124,34 @@ node server.js # Zweryfikuj, czy serwer uruchamia się bez błędów ### Ogólne podejście do testowania -- 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 +- To repozytorium edukacyjne bez kompletnego automatycznego testowania +- Testowanie manualne koncentruje się na: + - Uruchamianiu przykładów kodu bez błędów + - Działających linkach w dokumentacji + - Pomyślnych kompilacjach projektów + - Przykładach zgodnych z najlepszymi praktykami -### Kontrole przed przesłaniem +### Kontrole przed zgłoszeniem - 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ą odpowiednią strukturę +- Zweryfikuj, czy linki markdown są poprawne +- Przetestuj przykłady kodu w przeglądarce lub Node.js +- Sprawdź, czy tłumaczenia zachowują poprawną strukturę ## Wytyczne dotyczące stylu kodu ### JavaScript - Używaj nowoczesnej składni ES6+ -- Stosuj standardowe konfiguracje ESLint dostarczone w projektach -- Używaj znaczących nazw zmiennych i funkcji dla klarowności edukacyjnej +- Stosuj standardowe konfiguracje ESLint dostarczane w projektach +- Używaj znaczących nazw zmiennych i funkcji dla jasności edukacyjnej - Dodawaj komentarze wyjaśniające koncepcje dla uczących się -- Formatowanie za pomocą Prettier tam, gdzie jest skonfigurowane +- Formatowanie przy pomocy Prettier tam, gdzie skonfigurowano ### HTML/CSS - Semantyczne elementy HTML5 -- Zasady responsywnego projektowania +- Zasady projektowania responsywnego - Jasne konwencje nazewnictwa klas - Komentarze wyjaśniające techniki CSS dla uczących się @@ -159,26 +159,26 @@ node server.js # Zweryfikuj, czy serwer uruchamia się bez błędów - Wytyczne stylu PEP 8 - Jasne, edukacyjne przykłady kodu -- Wskazówki typów tam, gdzie pomagają w nauce +- Adnotacje typów tam, gdzie pomagają w nauce ### Dokumentacja Markdown - Jasna hierarchia nagłówków -- Bloki kodu ze specyfikacją języka +- Bloki kodu z określeniem języka - Linki do dodatkowych zasobów - Zrzuty ekranu i obrazy w katalogach `images/` -- Tekst alternatywny dla obrazków dla dostępności +- Tekst alternatywny dla obrazów zgodnie z zasadami dostępności ### Organizacja plików - 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}/` +- Każdy projekt ma katalog `solution/` i często `start/` lub `your-work/` +- Obrazy przechowywane w katalogach `images/` związanych z lekcjami +- Tłumaczenia w strukturze `translations/{language-code}/` -## Budowanie i wdrażanie +## Budowa i wdrożenie -### Wdrażanie aplikacji quizowej (Azure Static Web Apps) +### Wdrożenie aplikacji quizowej (Azure Static Web Apps) Aplikacja quizowa jest skonfigurowana do wdrożenia na Azure Static Web Apps: @@ -190,10 +190,10 @@ npm run build # Tworzy folder dist/ Konfiguracja Azure Static Web Apps: - **Lokalizacja aplikacji**: `/quiz-app` -- **Lokalizacja wyjścia**: `dist` +- **Lokalizacja wyjściowa**: `dist` - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` -### Generowanie dokumentacji PDF +### Generowanie PDF dokumentacji ```bash npm install # Zainstaluj docsify-to-pdf @@ -207,74 +207,74 @@ npm install -g docsify-cli # Zainstaluj Docsify globalnie docsify serve # Serwuj na localhost:3000 ``` -### Budowy specyficzne dla projektów +### Budowy specyficzne dla projektu 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 +- Projekty Vue: `npm run build` tworzy produkcyjne pakiety +- Projekty statyczne: brak kroku budowy, serwowanie plików bezpośrednio ## Wytyczne dotyczące pull requestów ### Format tytułu Używaj jasnych, opisowych tytułów wskazujących obszar zmian: -- `[Quiz-app] Dodaj nowy quiz dla lekcji X` +- `[Quiz-app] Dodaj nowy quiz do lekcji X` - `[Lesson-3] Popraw literówkę w projekcie terrarium` - `[Translation] Dodaj tłumaczenie na hiszpański dla lekcji 5` -- `[Docs] Aktualizacja instrukcji konfiguracji` +- `[Docs] Aktualizuj instrukcje instalacji` ### Wymagane kontrole -Przed przesłaniem PR: +Przed zgłoszeniem PR: 1. **Jakość kodu**: - - Uruchom `npm run lint` w odpowiednich katalogach projektów - - Napraw wszystkie błędy i ostrzeżenia lint + - Uruchom `npm run lint` w dotkniętych katalogach projektów + - Napraw wszystkie błędy i ostrzeżenia lintingu -2. **Weryfikacja budowania**: +2. **Weryfikacja budowy**: - Uruchom `npm run build` jeśli dotyczy - - Sprawdź brak błędów budowania + - Upewnij się, że brak błędów budowy 3. **Weryfikacja linków**: - - Przetestuj wszystkie linki markdown - - Sprawdź działanie odwołań do obrazów + - Sprawdź wszystkie linki markdown + - Zweryfikuj poprawność odniesień do obrazów 4. **Przegląd treści**: - 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 + - Upewnienie się, że przykłady kodu są poprawne i edukacyjne + - Sprawdzenie, czy tłumaczenia zachowują oryginalne znaczenie -### Wymogi dotyczące wkładu +### Wymagania dotyczące wkładu -- Akceptacja Microsoft CLA (automatyczna weryfikacja przy pierwszym PR) +- Zgoda na 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) -- Wzmianka o numerach issue w opisie PR, jeśli dotyczy +- Sprawdź [CONTRIBUTING.md](./CONTRIBUTING.md) dla szczegółowych wytycznych +- Referuj numery zgłoszeń w opisie PR, jeśli dotyczy ### Proces przeglądu -- PR-y są przeglądane przez opiekunów i społeczność +- PR są przeglądane przez opiekunów i społeczność - Priorytetem jest jasność edukacyjna -- Przykłady kodu powinny opierać się na aktualnych najlepszych praktykach -- Tłumaczenia poddawane weryfikacji pod kątem dokładności i odpowiedniości kulturowej +- Przykłady kodu powinny stosować aktualne najlepsze praktyki +- Tłumaczenia sprawdzane pod kątem dokładności i zgodności kulturowej ## System tłumaczeń ### Automatyczne tłumaczenie -- Wykorzystuje GitHub Actions ze workflow co-op-translator -- Tłumaczy automatycznie na ponad 50 języków +- Wykorzystuje GitHub Actions z workflow co-op-translator +- Tłumaczy automatycznie na 50+ języków - Pliki źródłowe w głównych katalogach -- Przetłumaczone pliki w katalogach `translations/{kod-języka}/` +- Tłumaczone pliki w katalogach `translations/{language-code}/` -### Dodawanie ręcznych poprawek tłumaczeń +### Dodawanie ręcznych usprawnień tłumaczenia -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 zlokalizowaną zawartość quizów +1. Znajdź plik w `translations/{language-code}/` +2. Dokonaj poprawek zachowując strukturę +3. Upewnij się, że przykłady kodu pozostają funkcyjne +4. Przetestuj ewentualną lokalizację quizów -### Metadane tłumaczeń +### Metadane tłumaczenia Przetłumaczone pliki zawierają nagłówek metadanych: ```markdown @@ -291,7 +291,7 @@ CO_OP_TRANSLATOR_METADATA: ## Debugowanie i rozwiązywanie problemów -### Typowe problemy +### Częste problemy **Aplikacja quizowa nie uruchamia się**: - Sprawdź wersję Node.js (zalecane v14+) @@ -299,110 +299,110 @@ CO_OP_TRANSLATOR_METADATA: - Sprawdź konflikty portów (domyślnie Vite używa portu 5173) **Serwer API nie startuje**: -- Zweryfikuj, czy wersja Node.js spełnia minimalne wymagania (node >=10) -- Sprawdź, czy port nie jest już zajęty -- Upewnij się, że wszystkie zależności zainstalowano przez `npm install` +- Sprawdź, czy wersja Node.js spełnia minimum (node >=10) +- Sprawdź, czy port nie jest zajęty +- Upewnij się, że wszystkie zależności zainstalowane (`npm install`) **Rozszerzenie przeglądarki się nie ładuje**: -- Sprawdź poprawność formatu manifest.json -- Sprawdź błędy w konsoli przeglądarki -- Postępuj zgodnie z instrukcjami instalacji rozszerzenia dla danej przeglądarki +- Sprawdź prawidłowość pliku manifest.json +- Sprawdź konsolę przeglądarki pod kątem błędów +- Postępuj zgodnie z instrukcjami instalacji specyficznymi dla przeglądarki -**Problemy z projektem czatu w Pythonie**: -- Upewnij się, że jest zainstalowany pakiet OpenAI: `pip install openai` +**Problemy z projektem czatu Pythona**: +- Upewnij się, że pakiet OpenAI jest zainstalowany: `pip install openai` - Sprawdź, czy zmienna środowiskowa GITHUB_TOKEN jest ustawiona -- Zweryfikuj uprawnienia dostępu do GitHub Models +- Zweryfikuj uprawnienia do dostępu do modeli GitHub **Docsify nie serwuje dokumentacji**: -- Zainstaluj globalnie docsify-cli: `npm install -g docsify-cli` +- Zainstaluj docsify-cli globalnie: `npm install -g docsify-cli` - Uruchom z katalogu głównego repozytorium -- Sprawdź, czy istnieje plik `docs/_sidebar.md` +- Sprawdź, czy plik `docs/_sidebar.md` istnieje ### Wskazówki dotyczące środowiska deweloperskiego - Używaj VS Code z rozszerzeniem Live Server dla projektów HTML - Zainstaluj rozszerzenia ESLint i Prettier dla spójnego formatowania -- Korzystaj z DevTools w przeglądarce do debugowania JavaScriptu +- Używaj narzędzi deweloperskich przeglądarki do debugowania JavaScript - Dla projektów Vue zainstaluj rozszerzenie Vue DevTools do przeglądarki -### Rozważania dotyczące wydajności +### Rozważania wydajnościowe -- Duża liczba przetłumaczonych plików (ponad 50 języków) oznacza duże pełne klony +- Duża liczba przetłumaczonych plików (50+ języków) oznacza duże pełne klony - Używaj płytkiego klonowania, jeśli pracujesz tylko z treścią: `git clone --depth 1` -- Wyłącz tłumaczenia z wyszukiwania przy pracy z zawartością w języku angielskim -- Procesy budowania mogą być powolne przy pierwszym uruchomieniu (`npm install`, budowa Vite) +- Wyłącz tłumaczenia z przeszukiwania podczas pracy w wersji angielskiej +- Procesy budowy mogą być wolne przy pierwszym uruchomieniu (npm install, budowa Vite) -## Aspekty bezpieczeństwa +## Rozważania dotyczące bezpieczeństwa ### Zmienne środowiskowe -- Klucze API nigdy nie powinny być zatwierdzane do repozytorium +- Klucze API nigdy nie powinny być commitowane do repozytorium - Używaj plików `.env` (już w `.gitignore`) -- Dokumentuj wymagane zmienne środowiskowe w plikach README projektów +- Dokumentuj wymagane zmienne środowiskowe w README projektów -### Projekty Python +### Projekty Pythona -- Korzystaj ze środowisk wirtualnych: `python -m venv venv` -- Aktualizuj zależności +- Używaj wirtualnych środowisk: `python -m venv venv` +- Aktualizuj na bieżąco zależności - Tokeny GitHub powinny mieć minimalne wymagane uprawnienia -### Dostęp do GitHub Models +### Dostęp do modeli GitHub -- Wymagane są Personal Access Tokens (PAT) dla GitHub Models -- Tokeny powinny być przechowywane jako zmienne środowiskowe -- Nigdy nie zatwierdzaj tokenów ani danych uwierzytelniających +- Wymagane Personal Access Tokens (PAT) +- Tokeny przechowuj jako zmienne środowiskowe +- Nigdy nie commituj tokenów ani danych uwierzytelniających -## Dodatkowe uwagi +## Dodatkowe notatki ### Grupa docelowa -- Całkowicie początkujący w web developmencie +- Całkowici początkujący w tworzeniu stron internetowych - Studenci i samoucy -- Nauczyciele wykorzystujący program w klasach -- Zawartość zaprojektowana z myślą o dostępności i stopniowym budowaniu umiejętności +- Nauczyciele korzystający z programu nauczania w klasie +- Treści zaprojektowane pod kątem dostępności i stopniowego budowania umiejętności ### Filozofia edukacyjna -- Podejście oparte na nauce poprzez projekt +- Podejście oparte na nauce przez projekty - Częste sprawdzanie wiedzy (quizy) -- Ćwiczenia praktyczne z kodowania -- Przykłady zastosowań w świecie rzeczywistym -- Koncentracja na podstawach przed frameworkami +- Praktyczne ćwiczenia kodowania +- Przykłady zastosowań w rzeczywistych projektach +- Skupienie na podstawach przed frameworkami ### Utrzymanie repozytorium - Aktywna społeczność uczących się i współtwórców -- Regularne aktualizacje zależności i zawartości -- Monitorowanie issues i dyskusji przez opiekunów -- Aktualizacje tłumaczeń automatyzowane przez GitHub Actions +- Regularne aktualizacje zależności i treści +- Monitorowanie zgłoszeń i dyskusji przez opiekunów +- Aktualizacje tłumaczeń automatyzowane za pomocą GitHub Actions ### Powiązane zasoby - [Moduły Microsoft Learn](https://docs.microsoft.com/learn/) -- [Zasoby Student Hub](https://docs.microsoft.com/learn/student-hub/) +- [Materiały Student Hub](https://docs.microsoft.com/learn/student-hub/) - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) rekomendowany dla uczących się -- Dodatkowe kursy: AI generatywne, Data Science, ML, IoT dostępne +- Dodatkowe kursy: Generatywne AI, Data Science, ML, IoT dostępne w programie nauczania ### Praca z konkretnymi projektami -Szczegółowe instrukcje dotyczące indywidualnych projektów znajdują się w plikach README: +Szczegółowe instrukcje dotyczące poszczególnych projektów znajdują się w plikach README: - `quiz-app/README.md` - aplikacja quizowa Vue 3 - `7-bank-project/README.md` - aplikacja bankowa z uwierzytelnianiem -- `5-browser-extension/README.md` - rozwój rozszerzeń przeglądarki -- `6-space-game/README.md` - gra oparta na Canvas +- `5-browser-extension/README.md` - rozwój rozszerzenia przeglądarki +- `6-space-game/README.md` - gra na canvasie - `9-chat-project/README.md` - projekt asystenta czatu AI ### Struktura monorepo -Chociaż nie jest to tradycyjne monorepo, to repozytorium zawiera wiele niezależnych projektów: +Chociaż to nie jest tradycyjne monorepo, to repozytorium zawiera wiele niezależnych projektów: - Każda lekcja jest samodzielna - Projekty nie dzielą zależności - Pracuj nad pojedynczymi projektami bez wpływu na inne -- Sklonuj całe repozytorium, aby uzyskać pełne doświadczenie kursu +- Sklonuj całe repozytorium, aby uzyskać pełne doświadczenie programu nauczania --- -**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. +**Zastrzeżenie**: +Niniejszy dokument został przetłumaczony za pomocą usługi tłumaczenia AI [Co-op Translator](https://github.com/Azure/co-op-translator). Chociaż 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 dokument nadrzędny. W przypadku informacji o krytycznym znaczeniu zalecane jest skorzystanie z profesjonalnego tłumaczenia wykonywanego przez człowieka. Nie ponosimy odpowiedzialności za jakiekolwiek nieporozumienia lub błędne interpretacje wynikające z korzystania z 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 566d2aeca..7ac844d59 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-06T11:28:53+00:00", + "translation_date": "2026-02-06T12:55:24+00:00", "source_file": "AGENTS.md", "language_code": "tr" }, diff --git a/translations/tr/AGENTS.md b/translations/tr/AGENTS.md index cf049b704..8ab5c0b5a 100644 --- a/translations/tr/AGENTS.md +++ b/translations/tr/AGENTS.md @@ -1,28 +1,28 @@ # AGENTS.md -## Proje Genel Bakışı +## Proje Genel Bakış -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. +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ştirilen kapsamlı 12 haftalık bir kurstur ve JavaScript, CSS ve HTML içeren 24 uygulamalı ders barındırır. -### Temel Bileşenler +### Ana Bileşenler -- **Eğitim İçeriği**: Proje tabanlı modüllere organize edilmiş 24 yapılandırılmış ders +- **Eğitim İçeriği**: Proje bazlı modüllere ayrılmış 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 soruluk 48 quiz (ders öncesi/sonrası değerlendirmeler) -- **Çok Dilli Destek**: GitHub Actions ile 50+ dile otomatik çeviriler +- **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 çeviri - **Teknolojiler**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI projeleri için) ### Mimari - 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 dokümantasyon ve PDF olarak erişilebilir +- Her ders klasörü README, kod örnekleri ve çözümler içerir +- Bağımsız projeler farklı dizinlerde (quiz-app, çeşitli ders projeleri) +- GitHub Actions kullanan çeviri sistemi (co-op-translator) +- Docsify ile sunulan dokümantasyon ve PDF olarak erişilebilirlik ## Kurulum Komutları -Bu depo öncelikle eğitim içeriği tüketimi içindir. Belirli projelerle çalışmak için: +Bu depo öncelikle eğitim içeriği kullanımı içindir. Belirli projelerle çalışmak için: ### Ana Depo Kurulumu @@ -47,7 +47,7 @@ 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'i çalıştır +npm run lint # ESLint çalıştır npm run format # Prettier ile biçimlendir ``` @@ -56,7 +56,7 @@ npm run format # Prettier ile biçimlendir ```bash cd 5-browser-extension/solution npm install -# Tarayıcıya özel uzantı yükleme talimatlarını izleyin +# Tarayıcıya özel eklenti yükleme talimatlarını izleyin ``` ### Uzay Oyunu Projeleri @@ -64,7 +64,7 @@ npm install ```bash cd 6-space-game/solution npm install -# index.html dosyasını tarayıcıda açın veya Canlı Sunucu kullanın +# index.html dosyasını tarayıcıda açın veya Live Server kullanın ``` ### Sohbet Projesi (Python Backend) @@ -78,31 +78,31 @@ python api.py ## Geliştirme İş Akışı -### İçerik Katkıda Bulunanlar İçin +### İçerik Katkıcıları İçin -1. Depoyu GitHub hesabınıza **fork edin** -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 +1. Depoyu GitHub hesabınıza **fork**layın +2. Fork’unuzu yerel olarak **clone**layı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 pull request gönderin ### Öğrenenler İç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ı quizlerini çözün +1. Depoyu fork veya clone edin +2. Ders klasörlerinde sırasıyla gezin +3. Her ders için README dosyalarını okuyun +4. https://ff-quizzes.netlify.app/web/ adresinde ders öncesi quizlerini tamamlayın +5. Ders klasörlerindeki kod örnekleriyle çalışın +6. Ödev ve görevleri yapın +7. Ders sonrası quizlere katılın ### Canlı Geliştirme -- **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 +- **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 eklentisini kullanın +- **API Projeleri**: İlgili API dizinlerinde `npm start` komutunu çalıştırın ## Test Talimatları @@ -110,8 +110,8 @@ python api.py ```bash cd quiz-app -npm run lint # Kod stili sorunlarını kontrol et -npm run build # Derlemenin başarılı olduğunu doğrula +npm run lint # Kod stili sorunlarını kontrol edin +npm run build # Derlemenin başarılı olduğunu doğrulayın ``` ### Banka API Testi @@ -124,159 +124,159 @@ node server.js # Sunucunun hatasız başlatıldığını doğrula ### Genel Test Yaklaşımı -- 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 +- Bu eğitim deposunda kapsamlı otomatik testler yoktur +- Manuel testler şunlara odaklanır: + - Kod örnekleri hatasız çalışır + - Dokümantasyondaki bağlantılar düzgün çalışır + - Proje derlemeleri başarıyla tamamlanır + - Örnekler iyi uygulamaları takip eder ### Gönderim Öncesi Kontroller -- 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 +- Package.json bulunan dizinlerde `npm run lint` çalıştırın +- Markdown linklerinin geçerliliğini kontrol edin +- Kod örneklerini tarayıcı veya Node.js'de test edin +- Çevirilerin yapısının korunduğundan emin olun -## Kod Stili Yönergeleri +## Kod Stili Kılavuzları ### JavaScript -- Modern ES6+ sözdizimi kullanın -- Projelerde verilen standart ESLint yapılandırmalarına uyun -- 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) +- Modern ES6+ sözdizimi kullanılmalı +- Projelerde sağlanan standart ESLint konfigürasyonlarına uyulmalı +- Eğitim amaçlı olarak anlamlı değişken ve fonksiyon isimleri tercih edilmeli +- Kavramları açıklayan yorumlar eklenmeli +- Prettier ile formatlama yapılmalı (varsa) ### HTML/CSS -- Semantik HTML5 elementleri -- Responsive tasarım ilkeleri -- Anlaşılır sınıf isimlendirmeleri -- Öğrenenler için CSS tekniklerini açıklayan yorumlar +- Semantik HTML5 elementleri kullanılmalı +- Responsive tasarım prensiplerine uyulmalı +- Anlaşılır sınıf isimlendirme kuralları takip edilmeli +- CSS tekniklerini açıklayan yorumlar eklenmeli ### Python -- PEP 8 stil kuralları -- Açık ve eğitim odaklı kod örnekleri -- Öğrenimi kolaylaştırmak için tip ipuçları +- PEP 8 stil kurallarına uyulmalı +- Açık ve eğitim amaçlı kod örnekleri sunulmalı +- Öğrenme için faydalı yerlerde tip ipuçları kullanılmalı -### Markdown Dokümantasyon +### Markdown Dokümantasyonu -- Net başlık hiyerarşisi -- Dil belirtilmiş kod blokları -- Ek kaynaklara yönlendiren linkler -- `images/` klasöründe ekran görüntüleri ve görseller -- Erişilebilirlik için resimler alt metinleri +- Açık başlık hiyerarşisi +- Dil belirtilmiş kod blokları +- Ek kaynaklara bağlantılar +- `images/` klasörlerinde ekran görüntüleri ve resimler +- Erişilebilirlik için resimlere açıklayıcı alt metin ### Dosya Organizasyonu -- Dersler numaralandırılmış (1-getting-started-lessons, 2-js-basics, vb.) -- Her projenin `solution/` ve genellikle `start/` veya `your-work/` dizinleri var -- Derslere özgü `images/` klasörlerinde görseller saklanır -- Çeviriler `translations/{language-code}/` dizin yapısında +- Dersler numaralandırılmış ve sıralı (1-getting-started-lessons, 2-js-basics, vb.) +- Her projenin `solution/` ve sıklıkla `start/` veya `your-work/` klasörleri bulunur +- Resimler derslere özel `images/` klasörlerinde saklanır +- Çeviriler `translations/{language-code}/` yapısındadır ## Derleme ve Yayınlama ### Quiz Uygulaması Yayınlama (Azure Static Web Apps) -Quiz-app, Azure Static Web Apps için yapılandırılmıştır: +Quiz-app, Azure Static Web Apps yayını için yapılandırılmıştır: ```bash cd quiz-app npm run build # dist/ klasörü oluşturur -# main'e push yapıldığında GitHub Actions iş akışı ile dağıtım yapar +# main dalına push yapıldığında GitHub Actions iş akışı ile dağıtım yapar ``` -Azure Static Web Apps konfigürasyonu: -- **Uygulama dizini**: `/quiz-app` -- **Çıkış dizini**: `dist` -- **İş akışı**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` +Azure Static Web Apps yapılandırması: +- **Uygulama konumu**: `/quiz-app` +- **Çıktı konumu**: `dist` +- **Çalışma 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'tan PDF oluştur +npm install # docsify-to-pdf yükleyin +npm run convert # Docs'tan PDF oluşturun ``` -### Docsify Dokümantasyon +### Docsify Dokümantasyonu ```bash -npm install -g docsify-cli # Docsify'yi global olarak yükleyin -docsify serve # localhost:3000 üzerinde servis verin +npm install -g docsify-cli # Docsify'i global olarak kur +docsify serve # localhost:3000 üzerinde servis et ``` -### Proje Özel Derleme +### Proje Bazlı Derlemeler -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 +Her proje dizininde kendi derleme süreci olabilir: +- Vue projeleri: `npm run build` komutu prodüksiyon paketleri oluşturur +- Statik projeler: Derleme adımı yoktur, dosyalar doğrudan sunulur -## Pull Request (PR) Yönergeleri +## Pull Request Kılavuzları ### Başlık Formatı -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ı düzelt` -- `[Translation] Ders 5 İspanyolca çevirisi ekle` -- `[Docs] Kurulum talimatlarını güncelle` +Değişiklik yapılacak alanı açıkça belirtin: +- `[Quiz-app] Ders X için yeni quiz ekle` +- `[Lesson-3] Terrarium projesinde yazım hatası düzelt` +- `[Translation] Ders 5 için İspanyolca çeviri ekle` +- `[Docs] Kurulum talimatlarını güncelle` -### Gerekli Kontroller +### Gereken Kontroller -PR göndermeden önce: +PR göndermeden önce: -1. **Kod Kalitesi**: - - Etkilenen projelerde `npm run lint` çalıştırın - - Tüm hata ve uyarıları giderin +1. **Kod Kalitesi**: + - İlgili proje dizinlerinde `npm run lint` çalıştırın + - Tüm lint hatalarını ve uyarılarını düzeltin -2. **Derleme Doğrulama**: - - Uygunsa `npm run build` yapın - - Derleme hatası olmadığından emin olun +2. **Derleme Doğrulama**: + - Geçerliyse `npm run build` çalıştırın + - Derleme hatası olmadığından emin olun -3. **Link Doğrulama**: - - Tüm markdown linklerini test edin - - Görsel referanslarının çalıştığını kontrol edin +3. **Bağlantı Doğrulaması**: + - Tüm markdown linklerini test edin + - Resim referanslarının çalıştığını kontrol edin -4. **İçerik İncelemesi**: - - 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 +4. **İçerik İncelemesi**: + - Yazım ve dil bilgisi kontrolü yapın + - Kod örneklerinin doğru ve eğitici olduğunu doğrulayın + - Çevirilerin orijinal anlamı koruduğunu kontrol edin -### Katkı Gereksinimleri +### Katkı Koşulları -- Microsoft CLA onaylayın (ilk PR’de otomatik kontrol) -- [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 +- Microsoft CLA’ya (ilk PR’de otomatik kontrol) onay verilmeli +- [Microsoft Açık Kaynak Davranış Kuralları](https://opensource.microsoft.com/codeofconduct/) izlenmeli +- Detaylı kurallar için [CONTRIBUTING.md](./CONTRIBUTING.md) dosyasına bakılmalı +- PR açıklamasında ilgili issue numaraları belirtilmeli (varsa) ### İnceleme Süreci -- PR’lar bakımcılar ve topluluk tarafından incelenir -- 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 +- PR’ler bakımcılar ve topluluk tarafından incelenir +- Eğitimsel açıklık önceliklidir +- Kod örnekleri güncel en iyi uygulamaları takip etmelidir +- Çeviriler doğruluk ve kültürel uygunluk açısından gözden geçirilir ## Çeviri Sistemi ### Otomatik Çeviri -- GitHub Actions ile co-op-translator iş akışı kullanılır -- 50+ dile otomatik çeviri yapılır -- Kaynak dosyalar ana dizinlerde -- Çevrilmiş dosyalar `translations/{language-code}/` klasörlerinde +- GitHub Actions üzerinde co-op-translator akışı kullanılır +- 50+ dile otomatik çeviri yapılır +- Kaynak dosyalar ana dizinlerde bulunur +- Çevirilmiş dosyalar `translations/{language-code}/` klasörlerinde yer alır ### Manuel Çeviri İyileştirmeleri Ekleme -1. `translations/{language-code}/` içindeki dosyayı bulun -2. Yapıyı koruyarak iyileştirmeler yapın -3. Kod örneklerinin çalışmaya devam ettiğinden emin olun -4. Yerelleştirilmiş quiz içeriklerini test edin +1. `translations/{language-code}/` klasöründen ilgili dosya bulunur +2. Yapı korunarak iyileştirmeler yapılır +3. Kod örneklerinin işlevselliği korunur +4. Lokalize quiz içerikleri test edilir -### Çeviri Meta Verisi +### Çeviri Meta Verileri -Çevrilmiş dosyalar meta veri başlığı içerir: +Çevrilmiş dosyalar meta veri üst bilgisi 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 ç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. +Bu belge, AI çeviri hizmeti [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ız. Orijinal belge, kendi dilinde yetkili kaynak olarak kabul edilmelidir. Kritik bilgiler için profesyonel insan çevirisi önerilir. Bu çevirinin kullanımı sonucu oluşabilecek yanlış anlamalar veya yanlış yorumlamalardan sorumlu değiliz. \ No newline at end of file