From 812138e3ea54956e5089721f8716d28756c6b56c Mon Sep 17 00:00:00 2001 From: "localizeflow[bot]" Date: Mon, 20 Apr 2026 16:12:03 +0000 Subject: [PATCH] chore(i18n): sync translations with latest source changes (chunk 1/1, 6 changes) --- translations/lt/.co-op-translator.json | 2 +- translations/lt/AGENTS.md | 312 ++++++++++----------- translations/my/.co-op-translator.json | 2 +- translations/my/AGENTS.md | 358 ++++++++++++------------- translations/uk/.co-op-translator.json | 2 +- translations/uk/AGENTS.md | 332 +++++++++++------------ 6 files changed, 504 insertions(+), 504 deletions(-) diff --git a/translations/lt/.co-op-translator.json b/translations/lt/.co-op-translator.json index db4aa798b..e5bb83ac8 100644 --- a/translations/lt/.co-op-translator.json +++ b/translations/lt/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-04-06T17:53:48+00:00", + "translation_date": "2026-04-20T16:11:59+00:00", "source_file": "AGENTS.md", "language_code": "lt" }, diff --git a/translations/lt/AGENTS.md b/translations/lt/AGENTS.md index f984108d7..a10046fa7 100644 --- a/translations/lt/AGENTS.md +++ b/translations/lt/AGENTS.md @@ -2,42 +2,42 @@ ## Projekto apžvalga -Tai yra mokymo programos saugykla, skirta pradedantiesiems mokyti interneto kūrimo pagrindų. Mokymo programa yra visapusiškas 12 savaičių kursas, sukurtas Microsoft Cloud Advocates, apimantis 24 praktinius užsiėmimus apie JavaScript, CSS ir HTML. +Tai yra švietimo programa skirta mokyti pradedančiuosius interneto kūrimo pagrindų. Programa yra išsami 12 savaičių kursų sistema, sukurta Microsoft Cloud Advocates komandos, apimanti 24 praktines pamokas apie JavaScript, CSS ir HTML. ### Pagrindinės sudedamosios dalys -- **Mokomasis turinys**: 24 struktūruotos pamokos, organizuotos pagal projektus -- **Praktiniai projektai**: Terarium, Rašymo žaidimas, Naršyklės plėtinys, Kosminis žaidimas, Banko programa, Kodo redaktorius ir AI pokalbių asistentas -- **Interaktyvūs testai**: 48 testai po 3 klausimus kiekviename (prieš ir po pamokos vertinimai) -- **Daugiakalbė palaikymas**: automatizuoti vertimai į daugiau nei 50 kalbų per GitHub Actions +- **Švietimo turinys**: 24 struktūruotos pamokos, suskirstytos į projektų modulius +- **Praktiniai projektai**: Terariumas, Rašymo žaidimas, Naršyklės plėtinys, Kosminis žaidimas, Banko programa, Kodo redaktorius ir AI pokalbių asistentas +- **Interaktyvūs testai**: 48 testai po 3 klausimus kiekviename (prieš ir po pamokų įvertinimai) +- **Daugiakalbė palaikymas**: Automatizuoti vertimai į 50+ kalbų naudojant GitHub Actions - **Technologijos**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI projektams) ### Architektūra -- Mokomoji saugykla su pamokomis pagrįsta struktūra -- Kiekviena pamoka turi savo aplanką su README, kodo pavyzdžiais ir sprendimais +- Švietimo saugykla su pamokomis pagrįsta struktūra +- Kiekvienos pamokos aplanke yra README, kodo pavyzdžiai ir sprendimai - Atskiri projektai atskiruose kataloguose (quiz-app, įvairūs pamokų projektai) -- Vertimų sistema naudojant GitHub Actions (co-op-translator) +- Vertimo sistema naudojant GitHub Actions (co-op-translator) - Dokumentacija pateikiama per Docsify ir prieinama PDF formatu ## Diegimo komandos -Ši saugykla skirta pirmiausia mokomajam turiniui vartoti. Dirbant su konkrečiais projektais: +Šis saugykla yra skirta pirminiam švietimo turinio vartojimui. Dirbant su konkrečiais projektais: -### Pagrindinės saugyklos diegimas +### Pagrindinės saugyklos paruošimas ```bash git clone https://github.com/microsoft/Web-Dev-For-Beginners.git cd Web-Dev-For-Beginners ``` -### Testų programėlės diegimas (Vue 3 + Vite) +### Testų programėlės paruošimas (Vue 3 + Vite) ```bash cd quiz-app npm install npm run dev # Paleisti kūrimo serverį -npm run build # Kurti gamybai +npm run build # Sukurti gamybai npm run lint # Vykdyti ESLint ``` @@ -56,7 +56,7 @@ npm run format # Formatuoti su Prettier ```bash cd 5-browser-extension/solution npm install -# Vadovaukitės naršyklės specifinėmis plėtinių įkėlimo instrukcijomis +# Vadovaukitės naršyklei būdingomis plėtinių įkėlimo instrukcijomis ``` ### Kosminio žaidimo projektai @@ -67,39 +67,39 @@ npm install # Atidarykite index.html naršyklėje arba naudokite Live Server ``` -### Pokalbių projekto (Python backend) diegimas +### Pokalbių projektas (Python serveris) ```bash cd 9-chat-project/solution/backend/python pip install openai -# Nustatykite GITHUB_TOKEN aplinkos kintamąjį +# Nustatyti GITHUB_TOKEN aplinkos kintamąjį python api.py ``` -## Kūrimo darbo eiga +## Vystymo darbo eiga -### Turinio kūrėjams +### Turinį prisidedantiems -1. **Padarykite saugyklos fork’ą** į savo GitHub paskyrą -2. **Klonuokite savo fork’ą** vietoje +1. **Atšakokite saugyklą** į savo GitHub paskyrą +2. **Klonuokite savo atšaką** lokaliai 3. **Sukurkite naują šaką** savo pakeitimams -4. Redaguokite pamokų turinį arba kodo pavyzdžius -5. Išbandykite kodo pakeitimus susijusiuose projekto kataloguose -6. Pateikite pull request’us pagal indėlio taisykles +4. Atlikite turinio ar kodo pavyzdžių pakeitimus pamokose +5. Patikrinkite kodo pakeitimus atitinkamuose projekto kataloguose +6. Pateikite pull requests laikantis indėlio taisyklių ### Mokiniams -1. Padarykite fork’ą arba klonuokite saugyklą -2. Sekite pamokų katalogus nuosekliai -3. Skaitykite README failus kiekvienoje pamokoje -4. Užbaikite priešpamokinius testus adresu https://ff-quizzes.netlify.app/web/ +1. Atšakokite arba klonuokite saugyklą +2. Eikite sekantiems pamokų katalogams paeiliui +3. Skaitykite kiekvienos pamokos README failus +4. Atlikite priešpamokinius testus https://ff-quizzes.netlify.app/web/ 5. Dirbkite su kodo pavyzdžiais pamokų aplankuose 6. Atlikite užduotis ir iššūkius -7. Išbandykite po pamokos testus +7. Atlikite pastraipinius testus -### Tiesioginis kūrimas +### Tiesioginis vystymas -- **Dokumentacija**: paleiskite `docsify serve` pagrindiniame kataloge (3000 portas) +- **Dokumentacija**: paleiskite `docsify serve` pagrindiniame kataloge (portas 3000) - **Testų programėlė**: paleiskite `npm run dev` quiz-app kataloge - **Projektai**: naudokite VS Code Live Server plėtinį HTML projektams - **API projektai**: paleiskite `npm start` atitinkamuose API kataloguose @@ -111,84 +111,84 @@ python api.py ```bash cd quiz-app npm run lint # Patikrinkite kodo stiliaus problemas -npm run build # Patvirtinkite, kad sukūrimas pavyksta +npm run build # Patikrinkite, ar statyba sėkminga ``` ### Banko API testavimas ```bash cd 7-bank-project/api -npm run lint # Patikrinkite kodo stiliaus klaidas -node server.js # Patikrinkite, ar serveris paleidžiamas be klaidų +npm run lint # Patikrinti kodo stiliaus problemas +node server.js # Patvirtinti, kad serveris paleidžiamas be klaidų ``` ### Bendras testavimo metodas -- Tai yra mokomoji saugykla be išsamiai automatizuotų testų +- Tai švietimo saugykla be išsamios automatizuotos testavimo sistemos - Rankinis testavimas orientuotas į: - - Kodo pavyzdžių veikimą be klaidų - - Nuorodų dokumentacijoje veikimą - - Sėkmingą projektų surinkimą - - Pavyzdžių atitikimą geriausioms praktikoms + - Kodo pavyzdžių vykdymą be klaidų + - Dokumentacijos nuorodų veikimą + - Projekto sėkmingą sudarymą + - Pavyzdžius atitinkančius gerąsias praktikas -### Patikrinimai prieš pateikiant pakeitimus +### Prieš pateikiant patikrinimus - Paleiskite `npm run lint` kataloguose su package.json -- Patikrinkite, ar markdown nuorodos veikia -- Išbandykite kodo pavyzdžius naršyklėje arba Node.js -- Įsitikinkite, kad vertimai išlaiko struktūrą +- Patikrinkite markdown nuorodų galiojimą +- Testuokite kodo pavyzdžius naršyklėje arba Node.js aplinkoje +- Įsitikinkite, kad vertimai išlaiko tinkamą struktūrą ## Kodo stiliaus gairės ### JavaScript -- Naudokite modernią ES6+ sintaksę -- Laikykitės standartinių ESLint konfigūracijų projektuose -- Naudokite prasmingus kintamųjų ir funkcijų pavadinimus mokomajam aiškumui -- Rašykite komentarus, paaiškinančius koncepcijas mokiniams -- Formatuokite naudodami Prettier, jei konfigūruota +- Naudoti modernią ES6+ sintaksę +- Laikytis standartinių ESLint konfigūracijų projektuose +- Naudoti prasmingus kintamųjų ir funkcijų pavadinimus švietimui aiškinti +- Pridėti komentarus konceptų paaiškinimui mokiniams +- Formatuoti su Prettier, jei konfigūruota ### HTML/CSS -- Semantiniai HTML5 elementai -- Atsakingo dizaino principai -- Aiškios klasių vardų konvencijos -- Komentarai paaiškinantys CSS technikas mokiniams +- Semantikos atitinkantys HTML5 elementai +- Reaguojantis dizainas +- Aiškios klasių pavadinimų konvencijos +- Komentarai CSS technikoms paaiškinti mokiniams ### Python - PEP 8 stiliaus gairės -- Aiškūs, mokomieji kodo pavyzdžiai -- Tipų užuominos, kur naudingos mokymuisi +- Aiškūs, švietimui skirti kodo pavyzdžiai +- Tipo užuominos, jei padeda mokymuisi ### Markdown dokumentacija - Aiški antraščių hierarchija -- Kodo blokai su kalbos žymėjimu -- Nuorodos į papildomus šaltinius -- Ekrano nuotraukos ir paveikslėliai `images/` kataloguose -- Alt tekstas paveikslėliams prieinamumui +- Kodo blokai su kalbos nurodymu +- Nuorodos į papildomus išteklius +- Ekrano kopijos ir paveikslėliai `images/` kataloguose +- Alternatyvus tekstas paveikslėliams, siekiant prieinamumo ### Failų organizavimas -- Pamokos numeruojamos nuosekliai (1-getting-started-lessons, 2-js-basics ir kt.) +- Pamokos su numeriais paeiliui (1-getting-started-lessons, 2-js-basics ir kt.) - Kiekvienas projektas turi `solution/` ir dažnai `start/` arba `your-work/` katalogus -- Paveikslėliai saugomi kiekvienos pamokos `images/` aplankuose -- Vertimai saugomi `translations/{kalbos-kodas}/` struktūroje +- Paveikslėliai saugomi pamokai priskirtuose `images/` aplankuose +- Vertimai saugomi `translations/{language-code}/` kataloguose -## Surinkimas ir diegimas +## Sudarymas ir diegimas ### Testų programėlės diegimas (Azure Static Web Apps) -Quiz-app sukonfigūruotas Azure Static Web Apps diegimui: +quiz-app yra sukonfigūruota Azure Static Web Apps diegimui: ```bash cd quiz-app npm run build # Sukuria dist/ aplanką -# Diegia per GitHub Actions darbo eigą, kai į pagrindinę šaką įdedama nauja versija +# Diegia naudojant GitHub Actions darbo eigą, kai stumiama į main ``` -Azure Static Web Apps konfigūracija: +Azure Static Web Apps konfiguracija: - **Programėlės vieta**: `/quiz-app` - **Išvesties vieta**: `dist` - **Darbo eiga**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` @@ -197,31 +197,31 @@ Azure Static Web Apps konfigūracija: ```bash npm install # Įdiekite docsify-to-pdf -npm run convert # Generuoti PDF iš dokumentų +npm run convert # Sugeneruoti PDF iš dokumentų ``` ### Docsify dokumentacija ```bash npm install -g docsify-cli # Įdiekite Docsify globaliai -docsify serve # Tiekite per localhost:3000 +docsify serve # Paleiskite serveryje localhost:3000 ``` -### Projektams būdingi surinkimo veiksmai +### Projektui specifiniai sudarymai -Kiekviename projekto kataloge gali būti savas surinkimo procesas: -- Vue projektai: `npm run build` sukuria gamybinius paketus -- Statiniai projektai: nėra surinkimo žingsnio, failai tiesiogiai tiekiami +Kiekvienas projekto katalogas gali turėti savo sudarymo procesą: +- Vue projektai: `npm run build` sukuria gamybines pakuotes +- Statiniai projektai: nėra sudarymo žingsnio, failai pateikiami tiesiogiai -## Pull request gairės +## Pull Request gairės -### Pavadinimų formatas +### Antraštės formatas Naudokite aiškius, aprašomuosius pavadinimus, nurodančius pakeitimo sritį: -- `[Quiz-app] Įdėti naują testą pamokai X` -- `[Lesson-3] Ištaisytas rašybos klaida terariumo projekte` -- `[Translation] Įterptas ispaniškas vertimas pamokai 5` -- `[Docs] Atnaujintos diegimo instrukcijos` +- `[Quiz-app] Pridėti naują testą pamokai X` +- `[Lesson-3] Ištaisyti klaidą terariumo projekte` +- `[Translation] Pridėti ispanų vertimą pamokai 5` +- `[Docs] Atnaujinti diegimo instrukcijas` ### Būtini patikrinimai @@ -229,49 +229,49 @@ Prieš pateikiant PR: 1. **Kodo kokybė**: - Paleiskite `npm run lint` paveiktuose projekto kataloguose - - Ištaisyti visus lint klaidų ir įspėjimų pranešimus + - Ištaisykite visas lint klaidas ir įspėjimus -2. **Surinkimo patikra**: +2. **Sudarymo patikra**: - Jei taikoma, paleiskite `npm run build` - - Užtikrinkite, kad nėra surinkimo klaidų + - Užtikrinkite, kad nėra sudarymo klaidų -3. **Nuorodų tikrinimas**: +3. **Nuorodų validacija**: - Išbandykite visas markdown nuorodas - - Patikrinkite paveikslėlių nuorodas + - Patikrinkite, ar paveikslėlių nuorodos veikia 4. **Turinio peržiūra**: - - Redagavimas dėl rašybos ir gramatikos - - Užtikrinkite, kad kodo pavyzdžiai yra teisingi ir mokomieji - - Patikrinkite, ar vertimai išlaiko originalią prasmę + - Tikrinkite rašybą ir gramatiką + - Užtikrinkite, kad kodo pavyzdžiai tinkami ir švietimo tikslais + - Patikrinkite, ar vertimai išlaiko pradinę prasmę ### Indėlio reikalavimai -- Sutikite su Microsoft CLA (automatizuotas patikrinimas pirmam PR) -- Laikykitės [Microsoft atvirojo kodo elgesio kodekso](https://opensource.microsoft.com/codeofconduct/) -- Žr. [CONTRIBUTING.md](./CONTRIBUTING.md) dėl išsamesnių gairių -- Nurodykite problemų numerius PR aprašyme, jei taikoma +- Sutikite su Microsoft CLA (automatinis tikrinimas pirmo PR metu) +- Vadovaukitės [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) +- Peržiūrėkite [CONTRIBUTING.md](./CONTRIBUTING.md) dėl išsamios informacijos +- Nurodykite klausimų numerius PR aprašyme, jei taikoma -### Peržiūros procesas +### Apžvalgos procesas -- PR peržiūri prižiūrėtojai ir bendruomenė -- Prioritetas skiriamas mokomajam aiškumui -- Kodo pavyzdžiai turi atitikti dabartines geriausias praktikas -- Vertimai peržiūrimi dėl tikslumo ir kultūrinės tinkamumo +- PR apžvelgia priežiūrėtojai ir bendruomenė +- Prioritetas teikiamas mokymosi aiškumui +- Kodo pavyzdžiai turi laikytis dabartinių geriausių praktikų +- Vertimai peržiūrimi dėl tikslumo ir kultūrinio atitikimo -## Vertimų sistema +## Vertimo sistema ### Automatizuotas vertimas - Naudoja GitHub Actions su co-op-translator darbo eiga -- Automatiškai verčia į daugiau nei 50 kalbų +- Automatiškai verčia į 50+ kalbų - Šaltinio failai pagrindiniuose kataloguose -- Išversti failai saugomi `translations/{kalbos-kodas}/` kataloguose +- Išversti failai saugomi `translations/{language-code}/` kataloguose -### Rankinių vertimų patobulinimų pridėjimas +### Rankinių vertimo patobulinimų pridedimas -1. Raskite failą `translations/{kalbos-kodas}/` -2. Atlikite patobulinimus saugodami struktūrą -3. Įsitikinkite, kad kodo pavyzdžiai veikia +1. Suraskite failą `translations/{language-code}/` +2. Atlikite patobulinimus išlaikant struktūrą +3. Įsitikinkite, kad kodo pavyzdžiai veikia teisingai 4. Išbandykite lokalizuotą testų turinį ### Vertimų metaduomenys @@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA: --> ``` -## Derinimas ir trikčių šalinimas +## Derinimas ir problemų sprendimas -### Dažnos problemos +### Dažniausios problemos -**Testų programėlė nepaleidžiama**: +**Testų programėlė nesikrauna**: - Patikrinkite Node.js versiją (rekomenduojama v14+) -- Ištrinkite `node_modules` ir `package-lock.json`, vėl paleiskite `npm install` -- Pasitikrinkite, ar nėra prievado konflikto (numatyta: Vite naudoja 5173 prievadą) +- Ištrinkite `node_modules` ir `package-lock.json`, paleiskite dar kartą `npm install` +- Patikrinkite ar nėra uosto konflikto (numatytas: Vite naudoja 5173 portą) -**API serveris nepaleidžiamas**: -- Patikrinkite, ar Node.js versija atitinka reikalavimus (node >=10) -- Įsitikinkite, kad prievadas nėra užimtas -- Užtikrinkite, kad įdiegti visi priklausymai su `npm install` +**API serveris nesikrauna**: +- Įsitikinkite, kad Node.js versija atitinka minimalią (node >=10) +- Patikrinkite, ar uostas jau nenaudojamas +- Įsitikinkite, kad visos priklausomybės įdiegtos su `npm install` **Naršyklės plėtinys nesikrauna**: -- Patikrinkite, ar manifest.json tinkamai suformatuotas +- Patikrinkite, ar manifest.json teisingai suformatuotas - Peržiūrėkite naršyklės konsolę dėl klaidų -- Laikykitės naršyklės specifinių plėtinių diegimo instrukcijų +- Sekite naršyklės specifines plėtinių diegimo instrukcijas **Python pokalbių projekto problemos**: -- Įsitikinkite, kad įdiegtas OpenAI paketas: `pip install openai` -- Patikrinkite, ar nustatytas GITHUB_TOKEN aplinkos kintamasis -- Patikrinkite GitHub modelių prieigos leidimus +- Įdiekite OpenAI paketą: `pip install openai` +- Įsitikinkite, kad GITHUB_TOKEN aplinkos kintamasis nustatytas +- Patikrinkite GitHub Models prieigos teises -**Docsify nesuteikia dokumentacijos**: +**Docsify neduoda dokumentų**: - Įdiekite docsify-cli globaliai: `npm install -g docsify-cli` -- Paleiskite iš saugyklos šaknies katalogo -- Įsitikinkite, kad egzistuoja `docs/_sidebar.md` +- Paleiskite iš saugyklos šaknies +- Patikrinkite, ar egzistuoja `docs/_sidebar.md` -### Kūrimo aplinkos patarimai +### Vystymo aplinkos patarimai - Naudokite VS Code su Live Server plėtiniu HTML projektams -- Įdiekite ESLint ir Prettier plėtinius vientisam formatavimui +- Įdiekite ESLint ir Prettier plėtinius nuosekliam formatavimui - Naudokite naršyklės DevTools JavaScript derinimui -- Vue projektams įdiekite Vue DevTools naršyklės plėtinį +- Vue projektams naudokite Vue DevTools naršyklės plėtinį -### Veikimo optimizavimas +### Veikimo efektyvumo patarimai -- Daug išverstų failų (daugiau nei 50 kalbų) reiškia, kad pilni klonai yra dideli -- Naudokite seklią klonavimą, jei dirbate tik su turiniu: `git clone --depth 1` -- Vertimus išskirkite iš paieškų dirbant su anglų turiniu -- Surinkimo procesai gali būti lėtesni pirmą kartą (npm install, Vite build) +- Didelis išverstų failų kiekis (50+ kalbų) reiškia, kad pilni klonai dideli +- Naudokite paviršinį klonavimą, jei dirbate tik su turiniu: `git clone --depth 1` +- Dirbant su anglišku turiniu, išimkite vertimus iš paieškos +- Sudarymo procesai pirmą kartą gali būti lėti (npm install, Vite build) -## Saugumo svarstymai +## Saugumo aspektai ### Aplinkos kintamieji -- API raktai niekada neturėtų būti įtraukti į saugyklą +- API raktai niekada neturi būti įtraukiami į saugyklą - Naudokite `.env` failus (jau įtraukti į `.gitignore`) -- Dokumentuokite reikalingus aplinkos kintamuosius projekto README +- Reikalingi aplinkos kintamieji dokumentuojami projekto README ### Python projektai - Naudokite virtualias aplinkas: `python -m venv venv` - Laikykite priklausomybes atnaujintas -- GitHub token’ai turi turėti tik minimalias reikalingas teises +- GitHub tokenai turėtų turėti minimalias būtinas teises -### GitHub modelių prieiga +### GitHub Models prieiga -- Reikia asmeninių prieigos tokenų (PAT) GitHub modeliams -- Token’us saugokite kaip aplinkos kintamuosius -- Niekada nenaudokite commit’inant tokenų ar prisijungimo duomenų +- Reikalingi asmeniniai prieigos raktai (PAT) +- Raktai turi būti saugomi kaip aplinkos kintamieji +- Niekada neįtraukti jų į saugyklą ar viešinti ## Papildomos pastabos ### Tikslinė auditorija -- Visi pradedantieji interneto kūrime -- Studentai ir savarankiškai besimokantys -- Mokytojai, naudojantys mokymo programą klasėse -- Turinys pritaikytas prieinamumui ir palaipsniui įgyjamam įgūdžių augimui +- Visiškai pradedantieji interneto kūrime +- Studentai ir savarankiški besimokantieji +- Mokytojai, naudojantys programą klasėje +- Turinys sukonstruotas prieinamumui ir nuosekliam įgūdžių įgijimui -### Mokymosi filosofija +### Švietimo filosofija -- Mokymasis per projektus +- Mokymasis pagrįstas projektais - Dažni žinių patikrinimai (testai) -- Praktiniai kodo rašymo pratimai -- Realūs pritaikymo pavyzdžiai -- Dėmesys pagrindams prieš technologijų karkasus +- Praktiniai kodavimo užsiėmimai +- Realių projektų pavyzdžiai +- Dėmesys pagrindams prieš frameworks ### Saugyklos priežiūra -- Aktyvi mokinių ir prisidėjusiųjų bendruomenė -- Reguliarūs atnaujinimai priklausomybių ir turinio srityje -- Problemos ir diskusijos stebimos prižiūrėtojų -- Vertimų atnaujinimai automatiškai per GitHub Actions +- Aktyvi mokinių ir prisidėjusių bendruomenė +- Reguliarūs priklausomybių ir turinio atnaujinimai +- Klausimai ir diskusijos prižiūrimi saugyklos savininkų +- Vertimų atnaujinimai automatizuoti per GitHub Actions ### Susiję ištekliai - [Microsoft Learn moduliai](https://docs.microsoft.com/learn/) - [Studentų centras](https://docs.microsoft.com/learn/student-hub/) -- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) rekomenduojamas mokiniams -- Papildomi kursai: Generatyvinis AI, Duomenų mokslas, ML, IoT programos +- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) rekomenduojamas besimokantiesiems +- Papildomi kursai: Generatyvioji AI, Duomenų mokslas, ML, IoT programos ### Darbas su konkrečiais projektais -Išsamias instrukcijas žr. README failuose: +Išsamios individualių projektų instrukcijos pateiktos README failuose: - `quiz-app/README.md` - Vue 3 testų programėlė - `7-bank-project/README.md` - Banko programa su autentifikacija -- `5-browser-extension/README.md` - Naršyklės plėtinio kūrimas -- `6-space-game/README.md` - Canvas pagrindu sukurtas žaidimas +- `5-browser-extension/README.md` - Naršyklės plėtinių kūrimas +- `6-space-game/README.md` - Žaidimas su Canvas - `9-chat-project/README.md` - AI pokalbių asistento projektas ### Monorepo struktūra -Nors tai nėra tradicinis monorepozitorijus, ši saugykla talpina kelis nepriklausomus projektus: +Nors tai nėra tradicinis monorepo, ši saugykla turi kelis nepriklausomus projektus: - Kiekviena pamoka yra savarankiška -- Projektai nesidalija priklausomybėmis -- Dirbkite su atskirais projektais nesutrigdami kitų -- Klonuokite visą repo norėdami turėti visą mokymo programą +- Projektai nesidalina priklausomybėmis +- Darbai su atskirais projektais neturi įtakos kitiems +- Klonuokite visą saugyklą pilnam kursui gauti --- -**Atsakomybės apribojimas**: -Šis dokumentas buvo išverstas naudojant dirbtinio intelekto vertimo paslaugą [Co-op Translator](https://github.com/Azure/co-op-translator). Nors siekiame tikslumo, prašome atkreipti dėmesį, kad automatiniai vertimai gali turėti klaidų ar netikslumų. Originalus dokumentas jo gimtąja kalba laikomas autoritetingu šaltiniu. Svarbiai informacijai rekomenduojamas profesionalus žmogaus vertimas. Mes neatsakome už bet kokius nesusipratimus ar neteisingus aiškinimus, atsirandančius naudojant šį vertimą. +**Atsakomybės ribojimas**: +Šis dokumentas buvo išverstas naudojant dirbtinio intelekto vertimo paslaugą [Co-op Translator](https://github.com/Azure/co-op-translator). Nors stengiamės užtikrinti tikslumą, atkreipkite dėmesį, kad automatizuoti vertimai gali turėti klaidų ar netikslumų. Originalus dokumentas jo gimtąja kalba yra laikomas autoritetingu šaltiniu. Svarbiai informacijai rekomenduojamas profesionalus žmogiškasis vertimas. Mes neatsakome už bet kokius nesusipratimus ar klaidingas interpretacijas, kylančias naudojant šį vertimą. \ No newline at end of file diff --git a/translations/my/.co-op-translator.json b/translations/my/.co-op-translator.json index d92f6832c..9c68ab25e 100644 --- a/translations/my/.co-op-translator.json +++ b/translations/my/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-04-06T17:49:59+00:00", + "translation_date": "2026-04-20T16:09:05+00:00", "source_file": "AGENTS.md", "language_code": "my" }, diff --git a/translations/my/AGENTS.md b/translations/my/AGENTS.md index 0568d029b..2c4ebb236 100644 --- a/translations/my/AGENTS.md +++ b/translations/my/AGENTS.md @@ -2,27 +2,27 @@ ## Project Overview -ဒီဟာက web ဖန်တီးမှု အခြေခံသင်ခန်းစာတွေကို အစမှစသင်ကြားဖို့ အတွက် ပညာရေး အတွက် သင်ကြားမှု လေ့လာရေး စာစောင်တစ်ခု ဖြစ်ပါတယ်။ ဒီသင်ကြားရေးအစီအစဉ်ဟာ Microsoft Cloud Advocates တွေက ဖန်တီးထားတဲ့ ၁၂ ပတ်ကြာ သင်ရိုးအစီအစဉ် ပြည့်စုံပြီး၊ JavaScript, CSS နဲ့ HTML ကို အခြေခံဖြင့် ပြုလုပ်ထားတဲ့ လက်တွေ့လေ့ကျင့်ခန်း ၂၄ ခု ပါဝင်ပါတယ်။ +ဒါဟာ ဝဘ်ဒီဗလပ်မှန်အခြေခံမှုများကို စတင်လေ့လာသူများအတွက် သင်ကြားပေးရန် အရည်အချင်းမြှင့်ပညာရေး သင်ရိုးညွှန်းလမ်းကြောင်း ရှည်လျားသော ထောက်ပံ့မှုပလက်ဖောင်းတစ်ခု ဖြစ်သည်။ သင်ရိုးညွှန်းလမ်းကြောင်းမှာ Microsoft Cloud Advocates မှ ဖန်တီးထားသော 12 နာရီကြာ သင်တန်း ၁၂ ပတ် တစ်ခု ဖြစ်ပြီး JavaScript, CSS, နှင့် HTML ကို မျက်နှာသာသော သင်ခန်းစာ ၂၄ ခု ပါဝင်သည်။ ### Key Components -- **ပညာရေး အကြောင်းအရာ**: စီမံချက်အခြေခံ မော်ဂျူးများအဖြစ် အစီအစဉ်ပြုလုပ်ထားသော ၂၄ ခန်းသင်ခန်းစာများ -- **လက်တွေ့ပရောဂျက်များ**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, နဲ့ AI Chat Assistant -- **အပြန်အလှန် စမ်းသပ်မေးခွန်းများ**: ခန်းသင်ခန်းစာများမတိုင်မီနဲ့ပြီးနောက် အစီအစဉ် ၄၈ ခု၊ မေးခွန်း ၃ ခုစီ ပါဝင်သည် -- **ဘာသာစကား အတန်းပြိုင်ပံ့ပိုးမှု**: GitHub Actions အသုံးပြုပြီး ဘာသာပြန်မှု ၅၀ ကျော်ကို အလိုအလျောက်ပြုလုပ်ခြင်း +- **ပညာရေး အကြောင်းအရာများ**: စီစဉ်ထားသော သင်ခန်းစာ ၂၄ ခန်းများ၊ စီမံကိန်းလိုက် မော်ဂျူလ်များအဖြစ် +- **လက်တွေ့ ပရောဂျက်များ**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, နှင့် AI Chat Assistant +- **အပြန်အလှန် စာမေးပွဲများ**: တစ်ခုခြင်း သင်ခန်းစာ မတိုင်မီ နှင့် သင်ခန်းစာပြီးနောက် အကဲဖြတ်ရန် မေးခွန်း ၃ မျိုး ပါဝင်သည့် စာမေးပွဲ ၄၈ ခု +- **ဘာသာစကားပေါင်းများစွာ အထောက်အပံ့**: GitHub Actions မှ တစ်ဆင့် ဘာသာစကား ၅၀ ကျော် အလိုအလျောက် ဘာသာပြန်ခြင်း - **နည်းပညာများ**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI ပရောဂျက်များအတွက်) ### Architecture -- သင်ခန်းစာအခြေခံ ပညာရေး အရင်းအမြစ် -- ထိုသင်ခန်းစာကို ဖိုင်အတွင်း README, ကုဒ်ဥပမာ၊ ဖြေရှင်းနည်းများ ပါရှိသည် -- ပရောဂျက်များကို စတင်ဖိုင်ခွဲခြင်းဖြင့် (quiz-app, အကွာအဝေးရှိသောသင်ခန်းစာပရောဂျက်များ) -- GitHub Actions ဖြင့် ဘာသာပြန်မှုစနစ် တည်ဆောက်ထားသည် (co-op-translator) -- Docsify ဖြင့် စာတမ်းစာတမ်းများ ပေးပို့ပြီး PDF အဖြစ်လည်း ရနိုင် +- သင်ခန်းစာအခြေခံ ပညာရေး ဒေတာဗေ့စ် +- သင်ခန်းစာ တစ်ခုချင်း အတွင်း README, ကုဒ်နမူနာများ နှင့် နည်းလမ်း ဖြေရှင်းချက်များ ပါဝင်သည် +- စကြာ ဝင်ပေါက်ရှိသော ပရောဂျက်များ ကို ထူးခြားသော ဖိုလ်ဒါများတွင် ထားရှိသည် (quiz-app, စသည်) +- GitHub Actions (co-op-translator) ကို အသုံးပြု၍ ဘာသာပြန်စနစ် +- Docsify ဖြင့် စာရွက်စာတမ်းများကို ဝန်ဆောင်မှုပေးပြီး PDF အဖြစ်လည်းရနိုင်သည် ## Setup Commands -ဒီရေှာပလာ ဖြင့် ပညာရေးအကြောင်းအရာ အသုံးပြုရန်သာ ရည်ရွယ်ထားသည်။ သီးသန့် ပရောဂျက်များကို အလုပ်လုပ်ရန်။ +ဒီ ဒေတာဗေ့စ်ကို စင်စစ်ပညာရေး အကြောင်းအရာ အသုံးပြုရုံအတွက် အဓိက ရည်ရွယ်သည်။ အထူးပရောဂျက်များနှင့် လုပ်ကိုင်ရန်အတွက်: ### Main Repository Setup @@ -38,7 +38,7 @@ cd quiz-app npm install npm run dev # ဖွံ့ဖြိုးမှုဆာဗာကို စတင်ပါ npm run build # ထုတ်လုပ်မှုအတွက် တည်ဆောက်ပါ -npm run lint # ESLint ကို လည်ပတ်ပါ +npm run lint # ESLint ကို chạyပါ ``` ### Bank Project API (Node.js + Express) @@ -47,8 +47,8 @@ npm run lint # ESLint ကို လည်ပတ်ပါ cd 7-bank-project/api npm install npm start # API ဆာဗာ စတင်ပါ -npm run lint # ESLint ကို လည်ပတ်ပါ -npm run format # Prettier ဖြင့် ဖော်မတ်လုပ်ပါ +npm run lint # ESLint ကို ပြေးပါ +npm run format # Prettier ဖြင့် ပုံစံစစ်ဆေးပါ ``` ### Browser Extension Projects @@ -56,7 +56,7 @@ npm run format # Prettier ဖြင့် ဖော်မတ်လုပ် ```bash cd 5-browser-extension/solution npm install -# ဘရောက်ဇာအလိုက် သီးခြား extension ဖွင့်သည့် ညွှန်ကြားချက်များအား လိုက်နာရန် +# ဘရောက်ဇာအသီးသီးထည့်သွင်းနည်းလမ်းညွှန်များကိုလိုက်နာပါ ``` ### Space Game Projects @@ -64,7 +64,7 @@ npm install ```bash cd 6-space-game/solution npm install -# index.html ကို browser မှာဖွင့်ပါ သို့မဟုတ် Live Server ကိုသုံးပါ +# index.html ကို browser မှာဖွင့်ပါ သို့မဟုတ် Live Server ကိုအသုံးပြုပါ ``` ### Chat Project (Python Backend) @@ -72,7 +72,7 @@ npm install ```bash cd 9-chat-project/solution/backend/python pip install openai -# GITHUB_TOKEN ပတ်ဝန်းကျင်အပြောင်းအလဲတတ်သော သတ်မှတ်ပါ +# GITHUB_TOKEN ပတ်ဝန်းကျင်အပြောင်းအလဲ ကို သတ်မှတ်ပါ python api.py ``` @@ -80,29 +80,29 @@ python api.py ### For Content Contributors -1. **သင့် GitHub အကောင့်သို့ repo ကို fork လုပ်ပါ** -2. **သင့် fork ကို ဒေသတွင်း clone လုပ်ပါ** -3. **မပြောင်းလဲမှုအတွက် ဧရိယာအသစ်တစ်ခု ဖန်တီးပါ** -4. သင်ခန်းစာ အကြောင်းအရာ သို့မဟုတ် ကုဒ်ဥပမာများ ပြင်ဆင်ပါ -5. သက်ဆိုင်ရာ ပရောဂျက်ဖိုလ်ဒါများတွင် ကုဒ်ပြောင်းလဲမှုများ စမ်းသပ်ပါ -6. ပံ့ပိုးမှု လမ်းညွှန်ချက်အတိုင်း pull request များတင်သွင်းပါ +1. **ရိုက်နှိပ်ပြီး fork လုပ်ရန်** မိမိ၏ GitHub အကောင့်သို့ +2. **fork ကို clone လုပ်ပါ** ဒေသခံစနစ်သို့ +3. **သင်ပြင်ဆင်လိုသော ဗားရှင်း အသစ် ဖန်တီးပါ** +4. သင်ခန်းစာ အကြောင်းအရာ သို့မဟုတ် ကုဒ်နမူနာများ ပြင်ဆင်ပါ +5. ပရောဂျက်တွင် ကုဒ်ပြင်ဆင်မှုများ ရရှိပါက စမ်းသပ်ပါ +6. အကူအညီအဖွဲ့ ဆောင်ရွက်နေသော လမ်းညွှန်ချက်များအတိုင်း pull request တင်သွင်းပါ ### For Learners -1. Repo ကို fork လုပ် သို့မဟုတ် clone လုပ်ပါ -2. သင်ခန်းစာဖိုလ်ဒါများကို တရားဝင်လိုက်နာ ပြီး သွားပါ -3. ခန်းသင်စာများအတွက် README ဖိုင်များ ဖတ်ပါ -4. https://ff-quizzes.netlify.app/web/ တွင် သင်ခန်းစာမတိုင်မီ စစ်ဆေးမေးခွန်းများ ဖြေဆိုပါ -5. သင်ခန်းစာဖိုလ်ဒါများအတွင်း ကုဒ်ဥပမာများနှင့် လေ့ကျင့်ပါ -6. အလုပ်များနှင့် စိန်ခေါ်မှုများ ပြီးမြောက်ပါ -7. သင်ခန်းစာပြီးနောက် စစ်ဆေးမေးခွန်းများ ဖြေပါ +1. Fork လုပ် သို့မဟုတ် clone လုပ်ပါ +2. သင်ခန်းစာ ဖိုလ်ဒါများကို နောက်တတ်တိုက် တိုင်ရွက်ပါ +3. သင်ခန်းစာမျက်နှာများကို ဖတ်ရှုပါ +4. https://ff-quizzes.netlify.app/web/ တွင် သင်ခန်းစာမတိုင်မီ စာမေးပွဲ ဖြေဆိုပါ +5. သင်ခန်းစာဖိုလ်ဒါများတွင် ကုဒ်နမူနာများကို လေ့လာပါ +6. အလုပ်အပ်နှင့် စိန်ခေါ်မှုများ ပြီးမြောက်အောင် ဆောင်ရွက်ပါ +7. သင်ခန်းစာပြီးနောက် စာမေးပွဲများ ဖြေဆိုပါ ### Live Development -- **စာတမ်းစာရွက်များ**: root တွင် `docsify serve` နှင့် ကိုင်တွယ်ပါ (port 3000) -- **Quiz App**: quiz-app ဖိုလ်ဒါ၌ `npm run dev` ကို အသုံးပြုပါ -- **ပရောဂျက်များ**: HTML ပရောဂျက်များအတွက် VS Code Live Server extension သုံးပါ -- **API ပရောဂျက်များ**: သက်ဆိုင်ရာ API ဖိုလ်ဒါများတွင် `npm start` ကို run လုပ်ပါ +- **စာရွက်စာတမ်းများ**: ကိုယ်ပိုင် `docsify serve` ကို root တွင်ချပြရန် (port 3000) +- **Quiz App**: quiz-app ဖိုလ်ဒါတွင် `npm run dev` ဖြစ်စေပါ +- **ပရောဂျက်များ**: VS Code ရဲ့ Live Server extension ကို HTML ပရောဂျက်များအတွက် အသုံးပြုပါ +- **API ပရောဂျက်များ**: အဆိုပါ API ဖိုလ်ဒါများတွင် `npm start` ချပြပါ ## Testing Instructions @@ -110,173 +110,173 @@ python api.py ```bash cd quiz-app -npm run lint # ကုတ်ပုံစံပြဿနာများကို စစ်ဆေးပါ -npm run build # တည်ဆောက်မှု အောင်မြင်မှုကို သေချာပါစေ +npm run lint # ကုဒ်ပုံစံ ပြဿနာများကို စစ်ဆေးပါ +npm run build # ဖွဲ့စည်းမှု အောင်မြင်မှုကို အတည်ပြုပါ ``` ### Bank API Testing ```bash cd 7-bank-project/api -npm run lint # ကုဒ်ပုံစံ ပြဿနာများကို စစ်ဆေးပါ -node server.js # ဆာဗာ အမှားများမရှိဘဲ စတင်နိုင်ကြောင်း အတည်ပြုပါ +npm run lint # ကုဒ်စတိုင်ပြဿနာများကို စစ်ဆေးပါ +node server.js # အမှားများမရှိဘဲ ဆာဗာစတင်သည်ကို သေချာစစ်ဆေးပါ ``` ### General Testing Approach -- ဒီဟာက ပညာရေးအတွက် ဖြစ်ပြီး စက်ရုပ် စမ်းသပ်မှု ပြည့်စုံမရှိပါ -- လက်တွေ့စမ်းသပ်ခြင်း အခြေခံချက်များမှာ – - - ကုဒ်ဥပမာများ အမှားမရှိ များကို ပြေးနိုင်မှု - - စာတမ်းစာရွက်အတွင်း လင့်ခ်များ တိကျမှု - - ပရောဂျက်များ အဆင်သင့် ပြီးဆုံးမှု - - ဥပမာများ စံပြနည်းလမ်းများကို လိုက်နာခြင်း +- ဒေတာဗေ့စ်သည် အလိုအလျောက် စမ်းသပ်မှု ပုံမှန် မပါဝင်သော ပညာရေးစနစ်ဖြစ်သည် +- စမ်းသပ်မှုများကို လက်မှုပုံစံဖြင့် အောက်ပါအတိုင်း အာရုံစိုက်ပါသည် - + - ကုဒ်နမူနာများ အမှားမဖြစ်စေဘဲ ပြေးပါခြင်း + - စာရွက်စာတမ်းတွင် မျှဝေထားသော လင့်ခ်များ အလုပ်လုပ်ရခြင်း + - ပရောဂျက်တည်ဆောက်မှု ပြီးမြောက်ခြင်း + - နမူနာများသည် ကောင်းမွန်သော လေ့လာမှုနည်းလမ်းများကို လိုက်နာခြင်း ### Pre-submission Checks -- package.json တွင်ရှိသောဖိုလ်ဒါများတွင် `npm run lint` ရောစစ်ပါ -- Markdown လင့်ခ်များမှာ မှန်ကန်မှု ရှိ/မရှိ စစ်ဆေးပါ -- Browser သို့မဟုတ် Node.js တွင် ကုဒ်ဥပမာများ စစ်ဆေးပါ -- ဘာသာပြန်မှုများ ရိုးရှင်းမှု ထိန်းသိမ်းထားမှု စစ်ဆေးပါ +- package.json ပါဝင်သော ဖိုလ်ဒါများတွင် `npm run lint` ကို တင်သတ်ပါ +- markdown လင့်ခ်များကို မှန်ကန်ပြည့်စုံကြောင်း အတည်ပြုပါ +- ဘရောက်ဇာ နှင့် Node.js တို့တွင် ကုဒ်နမူနာများကို စမ်းသပ်ပါ +- ဘာသာပြန်မှုများ၏ ဖွဲ့စည်းမှု မြောက်မြားမှု ထိန်းသိမ်းထားမှု စိစစ်ပါ ## Code Style Guidelines ### JavaScript -- ခေတ်သစ် ES6+ စနစ်များ သုံးပါ -- ပရောဂျက်များတွင် ဖော်ပြထားသော standard ESLint ညွှန်ကြားချက်များ လိုက်နာပါ -- ပညာရေးအတွက် ရည်ရွယ်ချက်နဲ့ အသုံးပြုသည့် ပြောင်းလဲမှုနှင့် function အမည်များ အသုံးပြုပါ -- သင်ယူသူများအတွက် အကြောင်းအရာရှင်းလင်းမှု အတွက် မှတ်ချက် ထည့်ပါ -- Prettier ဖြင့် ဖော်မတ်လုပ်ပါ (သတ်မှတ်ထားသောနေရာတွင်) +- ခေတ်မီ ES6+ စာရေးနည်းကို အသုံးပြုပါ +- ပရောဂျက်အတွင်း ပါရှိသည့် standard ESLint ပြဿနာစနစ်ကို လိုက်နာပါ +- ပညာရေး ရည်ရွယ်ချက်အတွက် သီးခြား နာမည်များ အသုံးပြုပါ +- လေ့လာသူများအတွက် အဓိပ္ပာယ်ဖွင့်ရှင်းချက်များ စာသားတွေ ထည့်ပါ +- Prettier ဖြင့် ပုံစံ စနစ်တကျ ပြုပြင်ထားပါ (configured ရှိလျှင်သာ) ### HTML/CSS -- Semantic HTML5 element များအမြဲ သုံးပါ -- Responsive ဒီဇိုင်း သဘောတရားများ လိုက်နာပါ -- Class နာမည် သက်ဆိုင်ရာ သဘောထားအတိုင်း အသုံးပြုပါ -- CSS နည်းလမ်းများ အသုံးပြုမှု ရှင်းလင်းအောင် မှတ်ချက် ထည့်ပါ +- Semantic HTML5 element များအသုံးပြုခြင်း +- တုန့်ပြန်မှု ဒီဇိုင်း များကို ဆောင်ရွက်ခြင်း +- Class နာမည်များကို ရှင်းလင်းသတိပြုအသုံးပြုပါ +- CSS နည်းကျများအတွက် သင်ယူသူများအတွက် ရှင်းလင်းရေးသားချက်များ ထည့်ပါ ### Python -- PEP 8 စတိုင် ညွှန်ကြားချက် -- ပညာရေးအတွက် သန့်ရှင်းပြီး ရှင်းလင်းသော ကုဒ်ဥပမာများ -- သင်ယူရန် အတွက် သက်ဆိုင်သောနေရာတွင် တိုင်းတမ်းရေးပါ +- PEP 8 စံချိန်စံညွှန်းများ လိုက်နာပါ +- တိကျမြောက်မရှိ ပညာရေးကုဒ်နမူနာများ +- သင်ယူမှု အတွက် အကူအညီဖြစ်စေသည့် Type hints များထည့်ပါ ### Markdown Documentation -- ခေါင်းစဉ်ဆက်တက်မှု သေချာစွာ ပါဝင်မှု -- ဘာသာစကား သတ်မှတ်ချက်ပါ အကုဒ်ဘလော့ခ်များ -- ထပ်ဆောင်း အရင်းအမြစ်များချိတ်ဆက်မှု -- `images/` ဖိုလ်ဒါတွင် စက္ကန့်ပုံများ နဲ့ ဓာတ်ပုံများ -- ဓာတ်ပုံများအတွက် နားလည်စေသည့် alt စာသား +- ခေါင်းစဥ် အဆင့်လိုက် ရှင်းလင်းမှု +- ဝါကျဘာသာပြန်ထားသော ကုဒ် ဘလော့တွေ +- အသေးစိတ် ရင်းမြစ်များအတွက် လင့်ခ်များ +- `images/` ဖိုလ်ဒါများတွင် ပုံရိပ်များနှင့် စာရင်းများ +- ရှာဖွေသူများအတွက် ပုံများ၏ Alt စာသားများ ### File Organization -- သင်ခန်းစာများ သင်ခန်းစာ အမှတ် အလိုက် နေရာချထားမှု (1-getting-started-lessons, 2-js-basics, စသည်) -- ပရောဂျက်များတွင် `solution/` နဲ့ မကြာခဏ `start/` သို့မဟုတ် `your-work/` ဖိုလ်ဒါများ ပါဝင်သည် -- သင်ခန်းစာအလိုက် `images/` ဖိုလ်ဒါများတွင် ဓာတ်ပုံများ ထိန်းသိမ်းမှု -- ဘာသာပြန်ချက်များကို `translations/{language-code}/` ဖိုလ်ဒါတွင်ထားသည် +- သင်ခန်းစာများ ကို နံပါတ်လိုက် စီစဉ်ထား (1-getting-started-lessons, 2-js-basics, စသည်) +- ပရောဂျက်တစ်ခုချင်းစီတွင် `solution/` နှင့် တခုခုသော `start/` သို့မဟုတ် `your-work/` ဖိုလ်ဒါများပါဝင်သည် +- ပုံရိပ်များသည် သင်ခန်းစာအလိုက် `images/` ဖိုလ်ဒါများတွင် သိမ်းဆည်းထားသည် +- ဘာသာပြန်ထားသော ဖိုင်များကို `translations/{language-code}/` ဖိုလ်ဒါတွင် သိမ်းဆည်းထားသည် ## Build and Deployment ### Quiz App Deployment (Azure Static Web Apps) -quiz-app ကို Azure Static Web Apps အတွက် ပြင်ဆင်ထားသည် - +quiz-app သည် Azure Static Web Apps အဆောက်အအုံအတွက် ဆက်တင်ပြုလုပ်ထားသည် - ```bash cd quiz-app -npm run build # dist/ ဖိုဒါကို ဖန်တီးသည် -# main သို့ push လုပ်သောအခါ GitHub Actions workflow ဖြင့် တပ်ဆင်သည် +npm run build # dist/ အဖိုင်ထည် ဆောက်သည် +# main ထိ တင်သွင်းသောအခါ GitHub Actions workflow ဖြင့် တင်စစ်သည်။ ``` -Azure Static Web Apps ပြင်ဆင်မှု- -- **App တည်နေရာ**: `/quiz-app` -- **ထုတ်ပေးရာ တည်နေရာ**: `dist` +Azure Static Web Apps ဆက်တင်များ: +- **App ရှေ့နေရာ**: `/quiz-app` +- **အထွက် ရှေ့နေရာ**: `dist` - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` ### Documentation PDF Generation ```bash -npm install # docsify-to-pdf ကိုထည့်သွင်းပါ -npm run convert # docs မှ PDF ဖိုင်ဖန်တီးပါ +npm install # docsify-to-pdf ကို ထည့်သွင်းပါ +npm run convert # docs မှ PDF ကို ထုတ်လုပ်ပါ ``` ### Docsify Documentation ```bash -npm install -g docsify-cli # Docsify ကို တစ်ကမ္ဘာလုံးတွင် ထည့်သွင်းပါ -docsify serve # localhost:3000 တွင် Serve လုပ်ပါ +npm install -g docsify-cli # Docsify ကို ကမ္ဘာလုံးဆိုင်ရာ ထည့်သွင်းပါ +docsify serve # localhost:3000 တွင် ဝန်ဆောင်မှုပေးပါ ``` ### Project-specific Builds -ပရောဂျက်ဖိုလ်ဒါ တစ်ခုချင်းစီမှာ ဘယ်လို Build လုပ်ရမယ်ဆိုတာက ဤသို့ ဖြစ်နိုင်သည် - -- Vue ပရောဂျက်များ: `npm run build` ဖြင့် ထုတ်လုပ်မှု ဘယ်လ်များ ဖန်တီးခြင်း -- Static ပရောဂျက်များ: Build အဆင့်မလိုအပ်ဘဲ အမြဲတမ်း File များကို ဝန်ဆောင်မှုလုပ်ခြင်း +ပရောဂျက် တစ်ခုချင်းစီ၏ build လုပ်ငန်းစဉ်သည် မတူကွဲပြားနိုင်ပါသည် - +- Vue ပရောဂျက်များ: `npm run build` နှင့် production bundle များ ဖန်တီးသည် +- Static ပရောဂျက်များ: build လုပ်ခြင်းမရှိဘဲ ဖိုင်များကို တိုက်ရိုက် ဝန်ဆောင်မှု ပြုလုပ်သည် ## Pull Request Guidelines ### Title Format -ပြောင်းလဲမှု နေရာကို သေချာ ဖော်ပြနိုင်တဲ့ ခေါင်းစဉ်များ အသုံးပြုပါ - -- `[Quiz-app] Lesson X အတွက် Quiz အသစ် ထည့်သွင်းခြင်း` -- `[Lesson-3] Terrarium ပရောဂျက်ရှိ အမှား ပြင်ဆင်ခြင်း` -- `[Translation] Lesson 5 အတွက် စပိန်ဘာသာ ပြန်ထည့်ခြင်း` -- `[Docs] Setup လမ်းညွှန်ချက်များ အပ်ဒိတ်ခြင်း` +ပြင်ဆင်ချက် အကွာအဝေးပြသနိုင်စေရန် ခေါင်းစဉ်များကို ရှင်းလင်းဖော်ပြပါ: +- `[Quiz-app] သင်ခန်းစာ X အတွက် စာမေးပွဲ အသစ် ထည့်သွင်းပါ` +- `[Lesson-3] Terrarium ပရောဂျက်တွင် သိပ်ချောင်းမှုတစ်ခု ပြင်ဆင်သည်` +- `[Translation] သင်ခန်းစာ 5 အတွက် စပိန်ဘာသာပြန် ထည့်သွင်းပါ` +- `[Docs] အဆင်ပြေမှု နည်းလမ်းညွှန်ချက် များ ထပ်မံ ပြင်ဆင်ပါ` ### Required Checks -PR တင်မဲ့အချိန်မှာ သေချာ စစ်ဆေးရန် - +PR တင်မတိုင်မီ လူအတတ်ဆုံး စစ်ဆေးမှုများ - 1. **ကုဒ်အရည်အသွေး**: - - သက်ဆိုင်ရာ ပရောဂျက်ဖိုလ်ဒါတွင် `npm run lint` ပြေးပါ - - လင့်တ် error များနဲ့ သတိပေးချက်များကိုအားလုံး ပြင်ဆင်ပါ + - ဒဏ်ရာရှိသော ပရောဂျက် ဖိုလ်ဒါများတွင် `npm run lint` ထည့်ပြေးပါ + - lint အမှားများနှင့် သတိပေးချက်များအားလုံး ပြင်ဆင်သည် -2. **Build အတည်ပြုခြင်း**: - - Build လုပ်စရာရှိလျှင် `npm run build` ပြေးပါ - - Build error မရှိစေရန် သေချာ စစ်ဆေးပါ +2. **Build အတည်ပြုမှု**: + - မည်သည့် အခါတွင်မဆို `npm run build` ကို ပြေးပါ + - Build အမှား မရှိကြောင်း သေချာစေပါ -3. **Link စစ်ဆေးခြင်း**: - - Markdown link များအားလုံး စစ်ဆေးပါ - - ဓာတ်ပုံများ လင့်ခ် တွေရေးသည် မှန်ကြောင်း စစ်ဆေးပါ +3. **လင့်ခ် စစ်ဆေးမှု**: + - Markdown လင့်ခ်များအားလုံးကို စမ်းသပ်ပါ + - ပုံရိပ်ကိုင်တွယ်မှုများ ကို စစ်ဆေးပါ -4. **အကြောင်းအရာ သုံးသပ်ခြင်း**: - - သဒ္ဒါစစ်ဆေးပြီး စာလုံးပြားထဲမှားချက် မရှိစေရန် သေချာစစ်ပါ - - ကုဒ်ဥပမာများ မှန်ကန်ပြီး ပညာရေးအရ သင်ကြားမှုကောင်းမောင်းမှုရှိစေရန် ကြိုးစားပါ - - ဘာသာပြန်မှုများ ရိုးရိုးသားသား ပြန်လည်မည့် အကြောင်းအရာ တူညီမှုရှိစေရန် စစ်ဆေးပါ +4. **အကြောင်းအရာ ပြန်လည်သုံးသပ်မှု**: + - စာလုံးပေါင်းနှင့် အသံဖွဲ့မှု စစ်ဆေးပါ + - ကုဒ် နမူနာများ မှန်ကန်ပြီး ပညာရေးအတွက်သင့်တော်သည်ကို သေချာစေပါ + - ဘာသာပြန်မှုများသည် မူရင်း အဓိပ္ပါယ်ကို ထိန်းသိမ်းထားသည်ကို အတည်ပြုပါ ### Contribution Requirements -- Microsoft CLA ကို လက်မှတ်ထိုးပါ (ပထမဆုံး PR မှာ အလိုအလျောက် စစ်ဆေးပါလိမ့်မယ်) -- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ကိုလိုက်နာပါ -- အသေးစိတ်အတိုင်ပင်ခံရန် [CONTRIBUTING.md](./CONTRIBUTING.md) ဖတ်ပါ -- PR မှာ သက်ဆိုင်ရာ issue နံပါတ်များ ကိုဖော်ပြပါ +- Microsoft CLA (အသစ် PR အတွက် အလိုအလျောက် စစ်ဆေးမှု) ပေးအပ်ရန် သဘောတူပါရန် +- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ကို လိုက်နာပါ +- အသေးစိတ် လမ်းညွှန်မှုအတွက် [CONTRIBUTING.md](./CONTRIBUTING.md) ဖတ်ရှုပါ +- PR ဖေါ်ပြချက်တွင် ဆိုင်သော ပြဿနာအမှတ်များ ကို ပြုလုပ်ပါ ### Review Process -- PR များကို ထိန်းသိမ်းသူများနဲ့ နည်းပညာ ဖက် အသိုင်းအဝိုင်းက စစ်ဆေးပေးပါလိမ့်မယ် -- ပညာရေးအတွက် ရှင်းလင်းတင်ပြမှုကို ဦးစားပေးပါ -- ကုဒ်ဥပမာများ အကောင်းဆုံး Practices များနဲ့ လိုက်နာမှုရှိစေရန် ကြိုးစားပါ -- ဘာသာပြန်မှုများကို တိကျမှုနဲ့ ယဉ်ကျေးမှုအသုံးအနှုန်းမှန်ကန်မှုရှိစေရန် စစ်ဆေးပါ +- PR များကို မိမိ ဦးဆောင်သူများ နှင့် အသိုင်းအဝိုင်းက ရှင်းလင်း ပြန်လည်သုံးသပ်သည် +- ပညာရေး အပြည့်အဝ ရနိုင်ရေးကို ဦးစားပေးသည် +- ကုဒ် နမူနာများသည် လက်ရှိ အကောင်းဆုံးနည်းလမ်းများနှင့် ကိုက်ညီရမည် +- ဘာသာပြန်မှုများကို တိကျမှုနဲ့ ယဉ်ကျေးမှုသဘောထား အရ အကဲဖြတ်သည် ## Translation System ### Automated Translation -- GitHub Actions အသုံးပြုထားပြီး co-op-translator workflow ဖြင့် အလိုအလျောက် ဘာသာပြန်သည် -- ၅၀ ကျော် ဘာသာစကားများသို့ အချက်အလက်များ ဘာသာပြန်သည် -- မူလဖိုင်များကို main directories မှာထားသည် -- ဘာသာပြန်ပြီးဖိုင်များကို `translations/{language-code}/` ဖိုလ်ဒါတွင် ထားသည် +- GitHub Actions နှင့် co-op-translator workflow ကို အသုံးပြုသည် +- ဘာသာစကား ၅၀ ကျော်သို့ အလိုအလျောက် ဘာသာပြန်ပေးသည် +- မူရင်းဖိုင်များကို မူရင်း ဖိုလ်ဒါများတွင် တင်ရှိသည် +- ဘာသာပြန်သော ဖိုင်များကို `translations/{language-code}/` ကုဒ်လမ်းကြောင်းတွင်ထားသည် ### Adding Manual Translation Improvements -1. `translations/{language-code}/` မှ ဖိုင် ရှာပါ -2. ဖိုင်ကို အတူတကွ ပြုပြင်မှု ပြုလုပ်ပါ၊ ဖိုင် ဖွဲ့စည်းမှု ထိန်းသိမ်းပါ -3. ကုဒ်ဥပမာများ လုပ်ငန်းမှန်ကန်နေစေရန် သေချာစစ်ပါ -4. ဒေသခံ Quiz အကြောင်းအရာရှိလျှင် စမ်းသပ်ပါ +1. `translations/{language-code}/` ဖိုလ်ဒါအတွင်း ဖိုင်ရှာဖွေပါ +2. ဖွဲ့စည်းမှု မဖျက်ဆီးဘဲ တိုးတက်အောင် ပြင်ဆင်ပါ +3. ကုဒ်နမူနာများ အလုပ်လုပ်နိုင်မှု ထိန်းသိမ်းပါ +4. ဒေသဆိုင်ရာ စာမေးပွဲအကြောင်းအရာများ တင်ပြပါ ### Translation Metadata -ဘာသာပြန်ထားသော ဖိုင်များတွင် metadata header ပါဝင်သည် - +ဘာသာပြန်ထားသော ဖိုင်များတွင် metadata ခေါင်းစီးပါရှိသည် - ```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/uk/.co-op-translator.json b/translations/uk/.co-op-translator.json index bea625b38..1da447ff0 100644 --- a/translations/uk/.co-op-translator.json +++ b/translations/uk/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-04-06T17:51:02+00:00", + "translation_date": "2026-04-20T16:10:37+00:00", "source_file": "AGENTS.md", "language_code": "uk" }, diff --git a/translations/uk/AGENTS.md b/translations/uk/AGENTS.md index 76bcb446d..3f30569ee 100644 --- a/translations/uk/AGENTS.md +++ b/translations/uk/AGENTS.md @@ -1,28 +1,28 @@ # AGENTS.md -## Огляд проекту +## Огляд проєкту -Це навчальний репозиторій для викладання основ веб-розробки початківцям. Навчальний курс — це комплексний 12-тижневий курс, розроблений Microsoft Cloud Advocates, який містить 24 практичні уроки, що охоплюють JavaScript, CSS і HTML. +Це навчальний репозиторій курсу для викладання основ веб-розробки для початківців. Курс є всебічним 12-тижневим курсом, розробленим Microsoft Cloud Advocates, що включає 24 практичні уроки з JavaScript, CSS та HTML. ### Ключові компоненти -- **Навчальний контент**: 24 структуровані уроки, організовані у проектні модулі -- **Практичні проекти**: Терраріум, Гра на друкування, Розширення браузера, Космічна гра, Банківський додаток, Редактор коду та AI чат-асистент -- **Інтерактивні тести**: 48 тестів по 3 запитання в кожному (до і після уроку) -- **Підтримка кількох мов**: Автоматичні переклади більш ніж 50 мовами за допомогою GitHub Actions -- **Технології**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (для AI-проектів) +- **Навчальний контент**: 24 структуровані уроки, організовані в модулі, орієнтовані на проєкти +- **Практичні проєкти**: Терраріум, Гра на друку, Розширення браузера, Космічна гра, Банківський додаток, Код-редактор і AI чат-асистент +- **Інтерактивні вікторини**: 48 вікторин по 3 питання у кожній (до/після уроку) +- **Підтримка багатьох мов**: Автоматичний переклад більш ніж на 50 мов за допомогою GitHub Actions +- **Технології**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (для AI проєктів) ### Архітектура -- Навчальний репозиторій зі структурою на основі уроків -- Кожна папка уроку містить README, приклади коду та рішення -- Окремі проекти у власних директоріях (quiz-app, різні проекти уроків) -- Система перекладів через GitHub Actions (co-op-translator) -- Документація подається за допомогою Docsify та доступна у форматі PDF +- Репозиторій з навчальним контентом, структурованим за уроками +- Кожна директорія уроку містить README, приклади коду та рішення +- Окремі проєкти розміщені в власних папках (quiz-app, різні уроки) +- Система перекладів з використанням GitHub Actions (co-op-translator) +- Документація подається через Docsify і доступна у форматі PDF -## Команди налаштування +## Команди для налаштування -Цей репозиторій призначений головним чином для споживання навчального контенту. Для роботи з конкретними проектами: +Цей репозиторій призначений переважно для споживання навчального контенту. Для роботи з конкретними проєктами: ### Основне налаштування репозиторію @@ -37,72 +37,72 @@ cd Web-Dev-For-Beginners cd quiz-app npm install npm run dev # Запустити сервер розробки -npm run build # Збірка для продакшену +npm run build # Зібрати для продакшена npm run lint # Запустити ESLint ``` -### API проекту Bank (Node.js + Express) +### API Банківського проєкту (Node.js + Express) ```bash cd 7-bank-project/api npm install -npm start # Запустити API сервер +npm start # Запустити сервер API npm run lint # Запустити ESLint npm run format # Відформатувати за допомогою Prettier ``` -### Проекти розширень браузера +### Проєкти розширень браузера ```bash cd 5-browser-extension/solution npm install -# Дотримуйтесь інструкцій завантаження розширень, специфічних для браузера +# Дотримуйтесь інструкцій із завантаження розширень, специфічних для браузера ``` -### Проекти космічної гри +### Проєкти космічної гри ```bash cd 6-space-game/solution npm install -# Відкрийте index.html у браузері або використайте Live Server +# Відкрийте index.html у браузері або використовуйте Live Server ``` -### Проект чату (Python Backend) +### Проєкт чату (Python бекенд) ```bash cd 9-chat-project/solution/backend/python pip install openai -# Встановіть змінну оточення GITHUB_TOKEN +# Встановіть змінну середовища GITHUB_TOKEN python api.py ``` ## Робочий процес розробки -### Для авторів контенту +### Для внесення контенту -1. **Форкніть репозиторій** в свій акаунт GitHub -2. **Клонувати форк** локально +1. **Форкніть репозиторій** у свій акаунт GitHub +2. **Клонуйте ваш форк** локально 3. **Створіть нову гілку** для своїх змін -4. Вносьте зміни в контент уроків або приклади коду -5. Тестуйте всі зміни коду у відповідних директоріях проектів -6. Надсилайте pull-реквести, дотримуючись правил внесків +4. Внесіть зміни у контент уроків або приклади коду +5. Перевірте коди у відповідних директоріях проєктів +6. Надішліть pull request відповідно до інструкцій внесення змін ### Для учнів 1. Форкніть або клонувати репозиторій 2. Перейдіть послідовно до директорій уроків -3. Читайте README файли кожного уроку -4. Виконуйте тести перед уроком на https://ff-quizzes.netlify.app/web/ -5. Працюйте з прикладами коду у папках уроків +3. Читайте README в кожному уроці +4. Проходьте вікторини перед уроком на https://ff-quizzes.netlify.app/web/ +5. Працюйте з прикладами коду в папках уроків 6. Виконуйте завдання і виклики -7. Пройдіть тести після уроку +7. Проходьте вікторини після уроку ### Жива розробка -- **Документація**: Запуск `docsify serve` в корені (порт 3000) -- **Quiz App**: Запуск `npm run dev` в каталозі quiz-app -- **Проекти**: Використовуйте розширення VS Code Live Server для HTML-проектів -- **API-проекти**: Запуск `npm start` у відповідних директоріях API +- **Документація**: Запустіть `docsify serve` у корені (порт 3000) +- **Quiz App**: Запустіть `npm run dev` у директорії quiz-app +- **Проєкти**: Використовуйте розширення VS Code Live Server для HTML-проєктів +- **API проєкти**: Запустіть `npm start` у відповідних API директоріях ## Інструкції для тестування @@ -111,7 +111,7 @@ python api.py ```bash cd quiz-app npm run lint # Перевірте проблеми зі стилем коду -npm run build # Переконайтеся, що збірка успішна +npm run build # Переконайтеся, що збірка проходить успішно ``` ### Тестування Bank API @@ -125,158 +125,158 @@ node server.js # Переконайтеся, що сервер запуск ### Загальний підхід до тестування - Це навчальний репозиторій без комплексних автоматизованих тестів -- Ручне тестування зосереджене на: - - Запуску прикладів коду без помилок - - Практичній роботі посилань у документації - - Успішному завершенню збірок проектів - - Дотриманні кращих практик у прикладах +- Ручне тестування орієнтоване на: + - Запуск прикладів коду без помилок + - Правильну роботу посилань у документації + - Успішне збирання проєктів + - Відповідність прикладів найкращим практикам -### Перевірки перед поданням +### Перевірка перед подачею -- Запустіть `npm run lint` у директоріях із package.json -- Переконайтеся, що посилання у Markdown дійсні -- Перевірте приклади коду у браузері або Node.js -- Переконайтеся, що переклади зберігають правильну структуру +- Запустіть `npm run lint` у директоріях з package.json +- Перевірте валідність markdown посилань +- Тестуйте приклади коду у браузері або Node.js +- Перевірте, що переклади мають правильну структуру -## Керівництво зі стилю коду +## Керівництво по стилю коду ### JavaScript - Використовуйте сучасний синтаксис ES6+ -- Дотримуйтесь стандартних конфігурацій ESLint в проектах +- Дотримуйтесь стандартних ESLint конфігурацій проектів - Використовуйте зрозумілі імена змінних і функцій для навчальної ясності - Додавайте коментарі, що пояснюють концепції для учнів -- Форматуйте код за допомогою Prettier там, де це налаштовано +- Форматуйте код за допомогою Prettier, де налаштовано ### HTML/CSS - Семантичні елементи HTML5 - Принципи адаптивного дизайну -- Чіткі конвенції іменування класів +- Чітка система імен класів - Коментарі, що пояснюють CSS-техніки для учнів ### Python -- Відповідність стилю PEP 8 -- Чіткі, навчальні приклади коду -- Вказування типів там, де це корисно для навчання +- Дотримання стилю PEP 8 +- Зрозумілі, навчальні приклади коду +- Використання типових підказок, якщо це допомагає навчанню -### Документація Markdown +### Документація у Markdown - Чітка ієрархія заголовків -- Код-блоки з вказаною мовою +- Код-блоки з вказанням мови - Посилання на додаткові ресурси -- Знімки екрана та зображення у папках `images/` -- Атрибути alt для зображень для забезпечення доступності +- Скриншоти та зображення в папках `images/` +- Опис alt для зображень для доступності ### Організація файлів -- Уроки пронумеровані послідовно (1-getting-started-lessons, 2-js-basics і т.д.) -- Кожен проект має папки `solution/` та часто `start/` або `your-work/` -- Зображення зберігаються у папках `images/` для конкретних уроків -- Переклади у структурі `translations/{language-code}/` +- Уроки пронумеровані послідовно (1-getting-started-lessons, 2-js-basics тощо) +- Кожен проєкт має папки `solution/` та часто `start/` або `your-work/` +- Зображення зберігаються у папках уроків `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 workflow при пуші в main +# Виконує розгортання через workflow GitHub Actions при пуші в main ``` Конфігурація Azure Static Web Apps: -- **Місцезнаходження додатку**: `/quiz-app` -- **Місце вихідних файлів**: `dist` +- **Розташування додатку**: `/quiz-app` +- **Розташування результату**: `dist` - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` ### Генерація PDF документації ```bash npm install # Встановіть docsify-to-pdf -npm run convert # Генеруйте PDF з docs +npm run convert # Згенерувати PDF з docs ``` ### Документація 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] Виправлення опечатки у проекті терраріум` +Використовуйте чіткі, описові заголовки, що вказують область змін: +- `[Quiz-app] Додати нову вікторину для уроку X` +- `[Lesson-3] Виправити описку у проєкті терраріум` - `[Translation] Додати іспанський переклад для уроку 5` -- `[Docs] Оновлення інструкцій з налаштування` +- `[Docs] Оновити інструкції з налаштування` ### Обов’язкові перевірки -Перед поданням PR: +Перед подачею PR: 1. **Якість коду**: - - Запустіть `npm run lint` у відповідних директоріях проектів - - Виправте всі помилки та попередження lint + - Запустіть `npm run lint` у відповідних директоріях проєктів + - Виправте всі помилки і зауваження lint 2. **Перевірка збірки**: - - Запустіть `npm run build`, якщо застосовано - - Переконайтеся, що немає помилок збірки + - Запустіть `npm run build`, якщо застосовно + - Переконайтесь, що немає помилок збірки 3. **Перевірка посилань**: - - Перевірте всі посилання в markdown - - Переконайтеся, що посилання на зображення працюють + - Протестуйте всі markdown-посилання + - Перевірте роботу зображень -4. **Перегляд контенту**: - - Вичитування на орфографію та граматику - - Переконайтеся, що приклади коду коректні та навчальні +4. **Перевірка контенту**: + - Вичитка на орфографію та граматику + - Переконайтесь, що приклади коду коректні і навчальні - Перевірте, що переклади зберігають оригінальний зміст -### Вимоги до внеску +### Вимоги до внесення змін -- Погодитися з Microsoft CLA (автоматична перевірка при першому PR) -- Дотримуватися [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) -- Див. [CONTRIBUTING.md](./CONTRIBUTING.md) для детальних вказівок -- Вказувати номер issue в описі PR, якщо застосовано +- Погодьтеся з Microsoft CLA (автоматична перевірка при першому PR) +- Дотримуйтесь [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) +- Див. [CONTRIBUTING.md](./CONTRIBUTING.md) для детальних інструкцій +- Вказуйте номери issues у описі PR, якщо застосовно -### Процес рецензії +### Процес огляду -- PR переглядають підтримувачі і спільнота -- Пріоритет — навчальна зрозумілість -- Приклади коду повинні відповідати актуальним кращим практикам -- Переклади перевіряються на точність та культурну відповідність +- PR перевіряють мейнтейнери і спільнота +- Пріоритет надається навчальній зрозумілості +- Приклади коду мають відповідати сучасним кращим практикам +- Переклади перевіряються на точність і культурну відповідність -## Система перекладу +## Система перекладів ### Автоматичний переклад - Використовує GitHub Actions з workflow co-op-translator -- Перекладає автоматично на понад 50 мов -- Файли джерел у основних каталогах -- Перекладені файли в `translations/{language-code}/` +- Автоматично перекладає на понад 50 мов +- Файли-джерела у головних директоріях +- Переклади у `translations/{language-code}/` -### Додавання ручних покращень перекладів +### Додавання ручних покращень 1. Знайдіть файл у `translations/{language-code}/` 2. Внесіть покращення, зберігаючи структуру -3. Переконайтеся, що приклади коду залишаються працездатними -4. Тестуйте будь-який локалізований контент тестів +3. Переконайтесь, що приклади коду функціональні +4. Протестуйте локалізований контент вікторин -### Метадані перекладу +### Метадані перекладів -Перекладені файли містять заголовок із метаданими: +Перекладені файли містять метадані у шапці: ```markdown ``` -## Налагодження та усунення несправностей +## Відлагодження та усунення проблем -### Поширені проблеми +### Типові проблеми **Quiz app не запускається**: - Перевірте версію Node.js (рекомендується v14+) -- Видаліть `node_modules` та `package-lock.json`, потім запустіть `npm install` знову +- Видаліть `node_modules` і `package-lock.json`, запустіть `npm install` знову - Перевірте конфлікти портів (за замовчуванням Vite використовує порт 5173) **API сервер не запускається**: -- Переконайтеся, що версія Node.js відповідає мінімальній (node >=10) +- Перевірте версію Node.js (node >=10) - Перевірте, чи порт не зайнятий -- Переконайтеся, що всі залежності встановлені через `npm install` +- Переконайтесь, що всі залежності встановлені (`npm install`) **Розширення браузера не завантажується**: -- Перевірте правильність форматування manifest.json -- Перегляньте консоль браузера на помилки -- Дотримуйтесь інструкцій з встановлення для конкретного браузера +- Перевірте формат manifest.json +- Перегляньте помилки у консолі браузера +- Дотримуйтесь інструкцій установки для конкретного браузера -**Проблеми з Python чат-проектом**: -- Впевніться, що пакет OpenAI встановлений: `pip install openai` -- Переконайтеся, що встановлено змінну оточення GITHUB_TOKEN -- Перевірте права доступу до GitHub Models +**Проблеми з Python чат-проєктом**: +- Переконайтесь, що пакет OpenAI встановлений: `pip install openai` +- Перевірте наявність змінної середовища GITHUB_TOKEN +- Перевірте права доступу GitHub Models **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 для браузера +- Використовуйте VS Code з розширенням Live Server для HTML-проєктів +- Встановіть розширення ESLint і Prettier для консистентного форматування +- Використовуйте DevTools браузера для відлагодження JavaScript +- Для Vue проектів встановіть Vue DevTools браузерне розширення ### Особливості продуктивності -- Велика кількість перекладених файлів (понад 50 мов) означає, що повні клони великі -- Використовуйте shallow clone, якщо працюєте лише з контентом: `git clone --depth 1` -- Ігноруйте переклади при пошуку в англомовному контенті +- Велика кількість перекладів (50+ мов) призводить до великих повних клонів +- Використовуйте shallow clone, якщо працюєте тільки з контентом: `git clone --depth 1` +- Ігноруйте переклади в пошуку при роботі з англійським контентом - Процеси збірки можуть бути повільними при першому запуску (npm install, Vite build) -## Міркування з безпеки +## Заходи безпеки ### Змінні оточення -- API ключі ніколи не повинні комітися в репозиторій -- Використовуйте `.env` файли (вже є у `.gitignore`) -- Документуйте необхідні змінні оточення у README проектів +- API ключі ніколи не мають потрапляти у репозиторій +- Використовуйте `.env` файли (вже в `.gitignore`) +- Документуйте потрібні змінні в README проєктів -### Python-проекти +### Python проєкти -- Використовуйте віртуальні оточення: `python -m venv venv` -- Підтримуйте залежності оновленими -- Токени GitHub повинні мати мінімально необхідні права +- Використовуйте віртуальні середовища: `python -m venv venv` +- Оновлюйте залежності +- Токени GitHub повинні мати мінімальні необхідні дозволи ### Доступ до GitHub Models -- Потрібні Персональні Токени Доступу (PAT) для GitHub Models -- Токени зберігайте як змінні оточення -- Ніколи не комітьте токени або облікові дані +- Потрібні персональні токени доступу (PAT) для GitHub Models +- Токени зберігайте у змінних оточення +- Ніколи не комітьте токени чи облікові дані -## Додаткові зауваження +## Додаткові відомості ### Цільова аудиторія -- Повні початківці у веб-розробці -- Студенти і самонавчальні +- Повні новачки у веб-розробці +- Студенти та самонавчання - Викладачі, що використовують курс у класах -- Контент розроблено для доступності та поступового нарощування навичок +- Контент створено з орієнтацією на доступність і поступове нарощування навичок ### Освітня філософія -- Підхід заснований на проектному навчанні -- Часті перевірки знань (тести) +- Проєктно-орієнтоване навчання +- Часті перевірки знань (вікторини) - Практичні вправи з кодування -- Приклади застосування у реальному світі -- Акцент на основах перед роботою з фреймворками +- Приклади реальних застосувань +- Фокус на основах перед фреймворками ### Підтримка репозиторію -- Активна спільнота учнів і внесників +- Активна спільнота учнів і контрибуторів - Регулярні оновлення залежностей і контенту -- Моніторинг питань та дискусій підтримувачами -- Оновлення перекладів автоматизовані через GitHub Actions +- Моніторинг issues та дискусій мейнтейнерами +- Автоматичні оновлення перекладів через GitHub Actions -### Пов'язані ресурси +### Пов’язані ресурси -- [Модулі Microsoft Learn](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 доступні +- [Microsoft Learn modules](https://docs.microsoft.com/learn/) +- [Student Hub resources](https://docs.microsoft.com/learn/student-hub/) +- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) рекомендується для учнів +- Додаткові курси: генеративний AI, Data Science, ML, IoT -### Робота з конкретними проектами +### Робота з конкретними проєктами -Для детальних інструкцій по окремих проектах звертайтесь до README файлів у: -- `quiz-app/README.md` - Vue 3 додаток для тестів +Для детальних інструкцій з окремих проєктів дивіться README файли у: +- `quiz-app/README.md` - Vue 3 quiz додаток - `7-bank-project/README.md` - Банківський додаток з автентифікацією - `5-browser-extension/README.md` - Розробка розширення браузера - `6-space-game/README.md` - Розробка гри на Canvas -- `9-chat-project/README.md` - Проект AI чат-асистента +- `9-chat-project/README.md` - AI чат-асистент ### Структура монорепозиторію -Хоч це не традиційний монорепозиторій, він містить кілька незалежних проектів: +Хоча це не традиційний монорепозиторій, він містить кілька незалежних проєктів: - Кожен урок автономний -- Проекти не мають загальних залежностей -- Можна працювати з окремими проектами, не впливаючи на інші -- Для повного курсу клонувати весь репозиторій +- Проєкти не ділять залежності +- Можна працювати з окремими проєктами без впливу на інші +- Клонування всього репозиторію для повного досвіду курсу --- **Відмова від відповідальності**: -Цей документ був перекладений за допомогою сервісу штучного інтелекту [Co-op Translator](https://github.com/Azure/co-op-translator). Хоч ми і прагнемо до точності, будь ласка, майте на увазі, що автоматичні переклади можуть містити помилки або неточності. Оригінальний документ рідною мовою слід вважати авторитетним джерелом інформації. Для критично важливої інформації рекомендується звертатися до професійного людського перекладу. Ми не несемо відповідальності за будь-які непорозуміння чи неправильні тлумачення, що виникли внаслідок використання цього перекладу. +Цей документ був перекладений за допомогою сервісу автоматичного перекладу [Co-op Translator](https://github.com/Azure/co-op-translator). Хоча ми прагнемо до точності, будь ласка, майте на увазі, що автоматичні переклади можуть містити помилки або неточності. Оригінальний документ рідною мовою слід вважати авторитетним джерелом. Для критичної інформації рекомендується професійний переклад людиною. Ми не несемо відповідальності за будь-які непорозуміння або хибні тлумачення, що виникли внаслідок використання цього перекладу. \ No newline at end of file