msb-public
/
Web-Dev-For-Beginners
mirror of https://github.com/microsoft/Web-Dev-For-Beginners.git
1
0
Code Issues Projects Releases Wiki Activity

chore(i18n): sync translations with latest source changes (chunk 1/1, 9 changes)

Browse Source
pull/1774/head
localizeflow[bot] 6 months ago
parent 563b50d211
commit 0d7e8ebe9d
9 changed files with 1790 additions and 1785 deletions
Show Stats Download Patch File Download Diff File

6
translations/lt/.co-op-translator.json
Unescape View File

@ -1,7 +1,7 @@
{ {
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": { "1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8", "original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-06T17:16:43+00:00", "translation_date": "2026-03-27T23:07:04+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md", "source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "lt" "language_code": "lt"
}, },
@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T17:20:47+00:00", "translation_date": "2026-03-27T23:10:41+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "lt" "language_code": "lt"
}, },

746
translations/lt/1-getting-started-lessons/1-intro-to-programming-languages/README.md
View File

File diff suppressed because it is too large Load Diff

440
translations/lt/AGENTS.md
Unescape View File

@ -2,45 +2,45 @@
## Projekto apžvalga ## Projekto apžvalga
Tai yra edukacinio kurso saugykla, skirta pradedantiesiems mokyti pagrindų apie žiniatinklio kūrimą. Kursas yra išsamus 12 savaičių kursas, sukurtas Microsoft Cloud Advocates komandos, turintis 24 praktines pamokas, apimančias JavaScript, CSS ir HTML. Tai mokomasis mokymo planas, skirtas pradedantiesiems mokyti pagrindus apie interneto kūrimą. Šis mokymo planas yra išsamus 12 savaičių kursas, sukurtas Microsoft Cloud Advocates komandos, apimantis 24 praktinius užsiėmimus apie JavaScript, CSS ir HTML.
### Pagrindiniai komponentai ### Pagrindinės dalys
- **Edukacinis turinys**: 24 struktūruotos pamokos, organizuotos į projektinius modulius - **Mokomoji medžiaga**: 24 struktūrizuoti užsiėmimai, suskirstyti į projektinius modulius
- **Praktiniai projektai**: Terariumas, Rašymo žaidimas, Naršyklės plėtinys, Kosminis žaidimas, Banko programa, Kodo redaktorius ir DI pokalbių asistentas - **Praktiniai projektai**: Terariumas, Spausdinimo žaidimas, Naršyklės plėtinys, Kosmoso žaidimas, Banko programa, Kodo redaktorius ir AI pokalbių asistentas
- **Interaktyvūs testai**: 48 testai po 3 klausimus kiekvienas (prieš- ir po pamokos vertinimai) - **Interaktyvūs testai**: 48 testai po 3 klausimus kiekviename (prieš ir po pamokos vertinimai)
- **Daugiakalbė palaikymas**: Automatiniai vertimai į 50+ kalbų per GitHub Actions - **Daugiakalbė palaikymas**: Automatiniai vertimai į daugiau nei 50 kalbų per GitHub Actions
- **Technologijos**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (DI projektams) - **Technologijos**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI projektams)
### Architektūra ### Architektūra
- Edukacinė saugykla su pamokų struktūra - Mokomasis saugykla su pamokų struktūra
- Kiekvienos pamokos aplanke yra README, kodo pavyzdžiai ir sprendimai - Kiekviename pamokos kataloge yra README, kodo pavyzdžiai ir sprendimai
- Atskirti savarankiški projektai atskiruose kataloguose (quiz-app, įvairūs pamokų projektai) - Atskiri savarankiški projektai skirtinguose kataloguose (quiz-app, įvairūs pamokų projektai)
- Vertimų sistema naudojanti GitHub Actions (co-op-translator) - Vertimų sistema, naudojanti GitHub Actions (co-op-translator)
- Dokumentacija teikiama per Docsify ir prieinama PDF formatu - Dokumentacija teikiama per Docsify ir prieinama PDF formatu
## Nustatymo komandos ## Sąrankos komandos
Ši saugykla skirta daugiausia edukaciniam turiniui vartoti. Norint dirbti su specifiniais projektais: Ši saugykla pirmiausia skirta mokomosios medžiagos naudojimui. Darbas su konkrečiais projektais:
### Pagrindinės saugyklos nustatymas ### Pagrindinė saugyklos sąranka
```bash ```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners cd Web-Dev-For-Beginners
``` ```
### Apklaustuko programėlės nustatymas (Vue 3 + Vite) ### Quiz App sąranka (Vue 3 + Vite)
```bash ```bash
cd quiz-app cd quiz-app
npm install npm install
npm run dev # Paleisti kūrimo serverį npm run dev # Paleisti kūrimo serverį
npm run build # Sukurti gamybai npm run build # Statyti gamybai
npm run lint # Paleisti ESLint npm run lint # Vykdyti ESLint
``` ```
### Banko projekto API (Node.js + Express) ### Banko projekto API (Node.js + Express)
```bash ```bash
@ -50,24 +50,24 @@ npm start # Paleisti API serverį
npm run lint # Vykdyti ESLint npm run lint # Vykdyti ESLint
npm run format # Formatuoti su Prettier npm run format # Formatuoti su Prettier
``` ```
### Naršyklės plėtinių projektai ### Naršyklės plėtinių projektai
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
npm install npm install
# Vadovaukitės naršyklės specifinėmis plėtinių įkėlimo instrukcijomis # Laikykitės naršyklės specifinių plėtinių įkėlimo instrukcijų
``` ```
### Kosminio žaidimo projektai ### Kosmoso žaidimo projektai
```bash ```bash
cd 6-space-game/solution cd 6-space-game/solution
npm install npm install
# Atidarykite index.html naršyklėje arba naudokite Live Server # Atidarykite index.html naršyklėje arba naudokite Live Server
``` ```
### Pokalbių projekto (Python backend) nustatymai ### Pokalbių projekto (Python backend) sąranka
```bash ```bash
cd 9-chat-project/solution/backend/python cd 9-chat-project/solution/backend/python
@ -75,208 +75,208 @@ pip install openai
# Nustatykite GITHUB_TOKEN aplinkos kintamąjį # Nustatykite GITHUB_TOKEN aplinkos kintamąjį
python api.py python api.py
``` ```
## Kūrimo darbo eiga
## Vystymo darbo eiga ### Turinio prisidedantiems
### Turinio bendradarbiams
1. **Padarykite fork’ą** saugyklos į savo GitHub paskyrą 1. **Sukurti atšaką** saugyklos savo GitHub paskyroje
2. **Klonuokite savo fork’ą** vietoje 2. **Klonuoti atšaką** lokaliai
3. **Sukurkite naują šaką** savo pakeitimams 3. **Sukurti naują šaką** savo pakeitimams
4. Keiskite pamokų turinį arba kodo pavyzdžius 4. Redaguoti pamokų turinį arba kodo pavyzdžius
5. Išbandykite kodo pakeitimus atitinkamuose projekto kataloguose 5. Išbandyti kodo pakeitimus atitinkamuose projekto kataloguose
6. Pateikite pull request’us pagal indėlio taisykles 6. Pateikti pakeitimų užklausas pagal prisidėjimo gaires
### Besimokantiems ### Mokiniams
1. Padarykite fork arba klonuokite saugyklą 1. Atšaka arba klonas saugyklos
2. Nuosekliai pereikite per pamokų katalogus 2. Sekti pamokų katalogus eilės tvarka
3. Skaitykite kiekvienos pamokos README failus 3. Skaityti kiekvieno užsiėmimo README failus
4. Atlikite priešpamokinius testus adresu https://ff-quizzes.netlify.app/web/ 4. Atlikti testus prieš pamoką adresu https://ff-quizzes.netlify.app/web/
5. Dirbkite su kodo pavyzdžiais pamokų aplankuose 5. Dirbti su kodo pavyzdžiais pamokų kataloguose
6. Atlikite užduotis ir iššūkius 6. Atlikti užduotis ir iššūkius
7. Atlikite postpamokinius testus 7. Atlikti testus po pamokos
### Gyvas vystymas ### Tiesioginis kūrimas
- **Dokumentacija**: Paleiskite `docsify serve` šakniniame aplanke (3000 prievadas) - **Dokumentacija**: paleisti `docsify serve` šakniniame kataloge (prievadas 3000)
- **Apklaustuko programėlė**: Paleiskite `npm run dev` quiz-app kataloge - **Quiz App**: paleisti `npm run dev` quiz-app kataloge
- **Projektai**: Naudokite VS Code Live Server plėtinį HTML projektams - **Projektai**: naudoti VS Code Live Server plėtinį HTML projektams
- **API projektai**: Paleiskite `npm start` atitinkuose API kataloguose - **API projektai**: paleisti `npm start` atitinkamuose API kataloguose
## Testavimo instrukcijos ## Testavimo instrukcijos
### Apklaustuko programėlės testavimas ### Quiz App testavimas
```bash ```bash
cd quiz-app cd quiz-app
npm run lint # Patikrinkite kodo stiliaus klaidas npm run lint # Patikrinkite kodo stiliaus problemas
npm run build # Patikrinkite, ar statyba sėkminga npm run build # Patvirtinkite, kad kūrimas sėkmingas
``` ```
### Banko API testavimas ### Banko API testavimas
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm run lint # Patikrinkite kodo stiliaus klaidas npm run lint # Patikrinti kodo stiliaus problemas
node server.js # Patikrinkite, ar serveris paleidžiamas be klaidų node server.js # Patvirtinti, kad serveris startuoja be klaidų
``` ```
### Bendras testavimo požiūris ### Bendras testavimo požiūris
- Tai edukacinė saugykla be išsamios automatizuotos testavimo sistemos - Tai mokomasis saugykla be išsamių automatinių testų
- Rankinis testavimas apima: - Rankinis testavimas daugiausia sutelktas į:
- Kodo pavyzdžiai veikia be klaidų - Kodo pavyzdžiai veikia be klaidų
- Dokumentacijos nuorodos veikia tinkamai - Dokumentacijos nuorodos veikia tinkamai
- Projektų kompiliacijos vyksta sėkmingai - Projektų kūrimas sėkmingas
- Pavyzdžiai atitinka gerąsias praktikas - Pavyzdžiai atitinka gerąsias praktikas
### Patikrinimai prieš pateikiant ### Prieš pateikiant patikrinimai
- Paleiskite `npm run lint` kataloguose su package.json - Paleisti `npm run lint` kataloguose su package.json
- Patikrinkite markdown nuorodų galiojimą - Patikrinti, ar markdown nuorodos galioja
- Išbandykite kodo pavyzdžius naršyklėje arba Node.js - Išbandyti kodo pavyzdžius naršyklėje arba Node.js
- Įsitikinkite, kad vertimai išlaiko tinkamą struktūrą - Patvirtinti, kad vertimai išlaiko tinkamą struktūrą
## Kodo stiliaus gairės ## Kodo stiliaus gairės
### JavaScript ### JavaScript
- Naudokite modernią ES6+ sintaksę - Naudoti modernią ES6+ sintaksę
- Laikykitės standartinių ESLint konfigūracijų projektuose - Laikytis standartinių ESLint konfigūracijų projektuose
- Naudokite prasmingus kintamųjų ir funkcijų pavadinimus mokymosi tikslams - Naudoti prasmingus kintamųjų ir funkcijų pavadinimus mokymuisi
- Pridėkite komentarus, paaiškinančius koncepcijas mokiniams - Pridėti komentarus, paaiškinančius sąvokas mokiniams
- Formatuokite naudodami Prettier, kur nustatyta - Formatuoti naudojant Prettier, kur tai konfigūruota
### HTML/CSS ### HTML/CSS
- Semantiški HTML5 elementai - Semantiški HTML5 elementai
- Responvyvaus dizaino principai - Reaguojantis dizainas
- Aiškios klasės pavadinimų konvencijos - Aiškios klasių pavadinimų konvencijos
- Komentarai, paaiškinantys CSS technikas mokiniams - Komentarai, paaiškinantys CSS metodikas mokiniams
### Python ### Python
- PEP 8 stiliaus gairės - PEP 8 stiliaus gairės
- Aiškūs, edukaciniai kodo pavyzdžiai - Aiškūs, mokomieji kodo pavyzdžiai
- Tipų anotacijos, jei naudingos mokymuisi - Rekomenduojami tipų užuominomis, kur naudingas mokymuisi
### Markdown dokumentacija ### Markdown dokumentacija
- Aiški antraščių hierarchija - Aiški antraščių hierarchija
- Kodo blokai su kalbos nurodymu - Kodo blokai su kalbos nurodymu
- Nuorodos į papildomus išteklius - Nuorodos į papildomus išteklius
- Ekrano nuotraukos ir paveikslėliai `images/` kataloguose - Ekrano nuotraukos ir vaizdai `images/` kataloguose
- Alt tekstas paveikslėliams prieinamumui užtikrinti - Alternatyvus tekstas vaizdams prieinamumui
### Failų organizacija ### Failų organizavimas
- Pamokos numeruojamos nuosekliai (1-getting-started-lessons, 2-js-basics ir kt.) - Pamokos numeruotos seka (1-getting-started-lessons, 2-js-basics ir t.t.)
- Kiekviename projekte yra `solution/` ir dažnai `start/` arba `your-work/` katalogai - Kiekviename projekte yra `solution/` ir dažnai `start/` arba `your-work/` katalogai
- Paveikslėliai saugomi pamokų specifiniuose `images/` aplankuose - Vaizdai saugomi konkrečių pamokų `images/` aplankuose
- Vertimai saugomi `translations/{language-code}/` struktūroje - Vertimai `translations/{language-code}/` struktūroje
## Kūrimas ir diegimas ## Kūrimas ir diegimas
### Apklaustuko programėlės diegimas (Azure Static Web Apps) ### Quiz App diegimas (Azure Static Web Apps)
quiz-app yra sukonfigūruotas Azure Static Web Apps diegimui: quiz-app konfigūruotas Azure Static Web Apps diegimui:
```bash ```bash
cd quiz-app cd quiz-app
npm run build # Sukuria dist/ aplanką npm run build # Sukuria dist/ aplanką
# Diegia per GitHub Actions darbo eigą, kai pushinama į main šaką # Diegia per GitHub Actions darbo eigą į pagrindinę šaką paspaudus
``` ```
Azure Static Web Apps konfigūracija:
- **Programos vieta**: `/quiz-app`
- **Išvesties vieta**: `dist`
- **Darbo eiga**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
Azure Static Web Apps konfigūracija: ### Dokumentacijos PDF generavimas
- **Programėlės vieta**: `/quiz-app`
- **Išvesties vieta**: `dist`
- **Vykdymo eiga**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Dokumentacijos PDF kūrimas
```bash ```bash
npm install # Įdiekite docsify-to-pdf npm install # Įdiekite docsify-to-pdf
npm run convert # Sugeneruokite PDF iš docs npm run convert # Sugeneruokite PDF iš dokumentų
``` ```
### Docsify dokumentacija ### Docsify dokumentacija
```bash ```bash
npm install -g docsify-cli # Įdiegti Docsify globaliai npm install -g docsify-cli # Įdiekite Docsify globaliai
docsify serve # Tarnauti localhost:3000 docsify serve # Aptarnauti localhost:3000
``` ```
### Projektų specifiniai kūrimo procesai
### Projektui būdingi kūrimo procesai Kiekvienas projekto katalogas gali turėti savą kūrimo procesą:
- Vue projektai: `npm run build` sukuria produkcinius paketus
Kiekvienas projekto katalogas gali turėti savo kūrimo procesą: - Statiniai projektai: Nereikia kūrimo žingsnio, failai tiekiami tiesiogiai
- Vue projektai: `npm run build` sukuria produkcinius paketus
- Statiniai projektai: be kūrimo žingsnio, failai pateikiami tiesiogiai
## Pull request gairės ## Pull Request gairės
### Pavadinimo formatas ### Pavadinimo formatas
Naudokite aiškius, apibūdinančius pakeitimus pavadinimus: Naudoti aiškius, apibūdinančius pavadinimus, nurodančius pakeitimo sritį:
- `[Quiz-app] Pridėti naują testą pamokai X` - `[Quiz-app] Add new quiz for lesson X`
- `[Lesson-3] Ištaisyta rašybos klaida terrarium projekte` - `[Lesson-3] Fix typo in terrarium project`
- `[Translation] Pridėtas ispanų kalbos vertimas pamokai 5` - `[Translation] Add Spanish translation for lesson 5`
- `[Docs] Atnaujintos nustatymo instrukcijos` - `[Docs] Update setup instructions`
### Būtini patikrinimai ### Reikalingi patikrinimai
Prieš pateikiant PR: Prieš pateikiant PR:
1. **Kodo kokybė**: 1. **Kodo kokybė**:
- Paleiskite `npm run lint` atitinkamuose projekto kataloguose - Paleisti `npm run lint` paveiktuose projekto kataloguose
- Ištaisyti visus lint klaidas ir įspėjimus - Ištaisyti visas lint klaidas ir įspėjimus
2. **Kūrimo patikrinimas**: 2. **Kūrimo patikra**:
- Jei taikoma, paleiskite `npm run build` - Jeigu taikoma, paleisti `npm run build`
- Užtikrinkite, kad nėra kūrimo klaidų - Užtikrinti, kad nebūtų kūrimo klaidų
3. **Nuorodų patikra**: 3. **Nuorodų tikrinimas**:
- Patikrinkite visas markdown nuorodas - Išbandyti visas markdown nuorodas
- Patikrinkite paveikslėlių nuorodas - Patikrinti, ar vaizdų nuorodos veikia
4. **Turinio peržiūra**: 4. **Turinio peržiūra**:
- Korektūra dėl rašybos ir gramatikos - Taisyti rašybos ir gramatikos klaidas
- Užtikrinkite, kad kodo pavyzdžiai yra teisingi ir edukaciniai - Užtikrinti, kad kodo pavyzdžiai būtų teisingi ir mokomieji
- Patikrinkite, kad vertimai išlaiko originalią prasmę - Patikrinti, kad vertimai atitinka originalią prasmę
### Indėlio reikalavimai ### Prisidėjimo reikalavimai
- Sutikite su Microsoft CLA (automatinis patikrinimas pirmojo PR metu) - Sutikti su Microsoft CLA (automatinis patikrinimas pirmo PR metu)
- Laikykitės [Microsoft atvirojo kodo elgesio taisyklių](https://opensource.microsoft.com/codeofconduct/) - Laikytis [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Matykite [CONTRIBUTING.md](./CONTRIBUTING.md) išsamioms gairėms - Perskaityti [CONTRIBUTING.md](./CONTRIBUTING.md) išsamioms gairėms
- Jei taikoma, nurodykite problemų numerius PR apraše - Nurodyti atitinkamus problemų numerius PR aprašyme, jei taikoma
### Peržiūros procesas ### Peržiūros procesas
- PR peržiūri prižiūrėtojai ir bendruomenė - PR peržiūri prižiūrėtojai ir bendruomenė
- Prioritetas suteikiamas edukaciniam aiškumui - Prioritetas skiriamas mokymosi aiškumui
- Kodo pavyzdžiai turi atitikti šiuolaikines gerąsias praktikas - Kodo pavyzdžiai turi atitikti dabartines gerąsias praktikas
- Vertimai peržiūrimi dėl tikslumo ir kultūrinio tinkamumo - Vertimai tikrinami dėl tikslumo ir kultūrinio atitikimo
## Vertimų sistema ## Vertimų sistema
### Automatizuotas vertimas ### Automatizuoti vertimai
- Naudoja GitHub Actions su co-op-translator workflow - Naudoja GitHub Actions su co-op-translator darbo eiga
- Automatiškai verčia į daugiau nei 50 kalbų - Automatiškai verčia į daugiau nei 50 kalbų
- Šaltinių failai pagrindiniuose kataloguose - Šaltinių failai pagrindiniuose kataloguose
- Išverstieji failai saugomi `translations/{language-code}/` kataloguose - Išversti failai `translations/{language-code}/` kataloguose
### Rankinių vertimo patobulinimų pridėjimas ### Rankinių vertimų patobulinimų pridėjimas
1. Raskite failą `translations/{language-code}/` kataloge 1. Rasti failą `translations/{language-code}/` kataloge
2. Atlikite patobulinimus išlaikydami struktūrą 2. Atlikti pataisas, išlaikant struktūrą
3. Užtikrinkite, kad kodo pavyzdžiai lieka veikiantys 3. Užtikrinti, kad kodo pavyzdžiai veiktų
4. Išbandykite lokalizuotą testų turinį 4. Išbandyti lokalizuotą testų turinį
### Vertimų meta duomenys ### Vertimų metaduomenys
Išverstieji failai turi meta antraštę: Išversti failai turi metaduomenų antraštę:
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -288,121 +288,121 @@ CO_OP_TRANSLATOR_METADATA:
} }
--> -->
``` ```
## Derinimas ir trikčių šalinimas ## Derinimas ir trikčių šalinimas
### Dažnos problemos ### Dažnos problemos
**Apklaustuko programėlė nepaleidžiama**: **Quiz app nepaleidžiamas**:
- Patikrinkite Node.js versiją (rekomenduojama v14+) - Patikrinti Node.js versiją (rekomenduojama v14+)
- Ištrinkite `node_modules` ir `package-lock.json`, tada paleiskite `npm install` iš naujo - Ištrinti `node_modules` ir `package-lock.json`, paleisti `npm install` iš naujo
- Patikrinkite, ar nėra prievado konfliktų (numatytasis: Vite naudoja prievadą 5173) - Patikrinti prievadų konfliktus (numatyta: Vite naudoja 5173 prievadą)
**API serveris nepaleidžiamas**: **API serveris nepaleidžiamas**:
- Įsitikinkite, kad Node.js versija atitinka minimalų reikalavimą (node >=10) - Patvirtinti, kad Node.js versija atitinka reikalavimus (node >=10)
- Patikrinkite, ar prievadas nėra užimtas - Patikrinti, ar prievadas nėra užimtas
- Užtikrinkite, kad visos priklausomybės įdiegtos per `npm install` - Įsitikinti, kad visos priklausomybės įdiegtos su `npm install`
**Naršyklės plėtinys nesikrauna**: **Naršyklės plėtinys neužsikrauna**:
- Patikrinkite, ar manifest.json yra tinkamai suformatuotas - Patikrinti, ar manifest.json formatas teisingas
- Patikrinkite naršyklės konsolę dėl klaidų - Peržiūrėti naršyklės konsolę klaidų
- Sekite naršyklės specifines plėtinių diegimo instrukcijas - Vadovautis naršyklės plėtinio diegimo instrukcijomis
**Python pokalbių projekto problemos**: **Python pokalbių projekto problemos**:
- Įsitikinkite, kad įdiegta OpenAI paketas: `pip install openai` - Įsitikinti, kad įdiegta OpenAI biblioteka: `pip install openai`
- Patikrinkite, ar nustatytas GITHUB_TOKEN aplinkos kintamasis - Patikrinti, ar nustatytas GITHUB_TOKEN aplinkos variable
- Patikrinkite prieigą prie GitHub modelių - Patikrinti GitHub Models prieigos leidimus
**Docsify neišveda dokumentacijos**: **Docsify nedemonstruoja dokumentų**:
- Įdiekite docsify-cli globaliai: `npm install -g docsify-cli` - Įdiegti docsify-cli globaliai: `npm install -g docsify-cli`
- Paleiskite iš saugyklos šaknies katalogo - Paleisti iš saugyklos šaknies
- Patikrinkite, ar egzistuoja `docs/_sidebar.md` - Patikrinti, ar egzistuoja `docs/_sidebar.md`
### Vystymo aplinkos patarimai ### Kūrimo aplinkos patarimai
- Naudokite VS Code su Live Server plėtiniu HTML projektams - Naudoti VS Code su Live Server plėtiniu HTML projektams
- Įdiekite ESLint ir Prettier plėtinius nuosekliam formatavimui - Įdiegti ESLint ir Prettier plėtinius nuosekliam formatavimui
- Naudokitės naršyklės kūrimo įrankiais JavaScript derinimui - Naudoti naršyklės DevTools JavaScript derinimui
- Vue projektams įdiekite Vue DevTools naršyklės plėtinį - Vue projektams įdiegti Vue DevTools naršyklės plėtinį
### Veikimo našumas ### Veikimo našumas
- Daug išverstų failų (50+ kalbų) reiškia dideles pilnas kopijas - Daug išverstų failų (daugiau nei 50 kalbų) reiškia didelius klonus
- Naudokite švelnų klonavimą, jei dirbate tik su turiniu: `git clone --depth 1` - Naudoti sekliu klonavimą, jei dirbama tik su turiniu: `git clone --depth 1`
- Išskirkite vertimus paieškose dirbdami su anglišku turiniu - Išskirti vertimus paieškose dirbant su anglų kalba
- Kūrimo procesai gali būti lėti pirmame paleidime (npm install, Vite build) - Kūrimo procesai gali būti lėti pirmo paleidimo metu (npm install, Vite build)
## Saugumo svarstymai ## Saugumo aspektai
### Aplinkos kintamieji ### Aplinkos kintamieji
- API raktai neturi būti įtraukti į saugyklą - API raktai neturi būti saugomi saugykloje
- Naudokite `.env` failus (jau įtraukti į `.gitignore`) - Naudoti `.env` failus (jau įtraukta į `.gitignore`)
- Dokumentuokite reikiamus aplinkos kintamuosius projektuose README - Dokumentuoti reikalingus aplinkos kintamuosius README failuose
### Python projektai ### Python projektai
- Naudokite virtualias aplinkas: `python -m venv venv` - Naudoti virtualias aplinkas: `python -m venv venv`
- Laikykite priklausomybes atnaujintas - Laikyti priklausomybes atnaujintas
- GitHub token’ai turi turėti minimalias reikalingas teises - GitHub tokenai turi turėti minimalias reikalingas teises
### GitHub modelių prieiga ### GitHub Models prieiga
- Reikalingi asmeniniai prieigos token’ai (PAT) GitHub modeliams - Reikalingi asmeniniai prieigos tokenai (PAT) GitHub Models
- Token’ai saugomi kaip aplinkos kintamieji - Tokenai laikomi aplinkos kintamuosiuose
- Niekada neįtraukite token’ų ar prisijungimo duomenų į saugyklą - Niekuomet neįtraukti tokenų ar prisijungimo duomenų į saugyklą
## Papildomos pastabos ## Papildomos pastabos
### Tikslinė auditorija ### Tikslinė auditorija
- Visiškai pradedantieji žiniatinklio kūrime - Absoliutūs pradedantieji interneto kūrime
- Studentai ir savarankiški besimokantieji - Studentai ir savarankiški mokymosi dalyviai
- Mokytojai, naudojantys kursą klasėse - Mokytojai, naudojantys mokymo planą klasėse
- Turinys sukurtas prieinamumui ir palaipsniui įgūdžių tobulinimui - Turinys pritaikytas prieinamumui ir palaipsniui įgūdžių ugdymui
### Edukacinė filosofija ### Mokymosi filosofija
- Mokymasis projekte pagrindu - Projektinis mokymasis
- Dažni žinių patikrinimai (testai) - Dažni žinių patikrinimai (testai)
- Praktinės kodo užduotys - Praktiniai programavimo užsiėmimai
- Realūs pavyzdžiai ir taikymas - Realūs taikymo pavyzdžiai
- Akcentas į pagrindus prieš karkasus - Dėmesys pagrindams prieš karkasus
### Saugyklos priežiūra ### Saugyklos priežiūra
- Aktyvi besimokančiųjų ir bendradarbių bendruomenė - Aktyvi mokinių ir prisidedančių bendruomenė
- Reguliarūs atnaujinimai priklausomybėms ir turiniui - Reguliarūs priklausomybių ir turinio atnaujinimai
- Problemos ir diskusijos prižiūrimos migratorių - Problemos ir diskusijos prižiūrimos vykdytojų
- Vertimų atnaujinimai automatizuoti per GitHub Actions - Vertimų atnaujinimai automatizuoti per GitHub Actions
### Susiję ištekliai ### Susiję ištekliai
- [Microsoft Learn moduliai](https://docs.microsoft.com/learn/) - [Microsoft Learn moduliai](https://docs.microsoft.com/learn/)
- [Studentų centras](https://docs.microsoft.com/learn/student-hub/) - [Studentų centro ištekliai](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) rekomenduojamas besimokantiesiems - Rekomenduojama naudoti [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) mokymuisi
- Papildomi kursai: Generatyvioji DI, Duomenų mokslas, ML, IoT kursai - Papildomi kursai: generatyvus AI, duomenų mokslas, ML, IoT
### Darbas su specifiniais projektais ### Darbas su konkrečiais projektais
Išsamios instrukcijos apie atskirus projektus yra README failuose: Išsamias instrukcijas apie atskirus projektus žr. README failuose:
- `quiz-app/README.md` - Vue 3 apklaustuko programa - `quiz-app/README.md` - Vue 3 viktorinos programa
- `7-bank-project/README.md` - Banko programa su autentifikacija - `7-bank-project/README.md` - Banko programa su autentifikacija
- `5-browser-extension/README.md` - Naršyklės plėtinių kūrimas - `5-browser-extension/README.md` - Naršyklės plėtinių kūrimas
- `6-space-game/README.md` - Canvas pagrindu sukurtas žaidimas - `6-space-game/README.md` - Canvas pagrindu veikiantis žaidimas
- `9-chat-project/README.md` - DI pokalbių asistento projektas - `9-chat-project/README.md` - AI pokalbių asistento projektas
### Monorepo struktūra ### Monorepo struktūra
Nors tai nėra tradicinis monorepo, ši saugykla apima kelis nepriklausomus projektus: Nors nėra tradicinė monorepo saugykla, ši saugykla talpina kelis nepriklausomus projektus:
- Kiekviena pamoka yra savarankiška - Kiekviena pamoka savaime užbaigta
- Projektai nesidalina priklausomybėmis - Projektai nesidalina priklausomybėmis
- Dirbkite su atskiromis projekto dalimis nesukeldami poveikio kitiems - Galima dirbti su atskirais projektais nepaveikiant kitų
- Klonuokite visą saugyklą pilnam kurso patyrimui - Norint gauti pilną mokymo patirtį, rekomenduojama klonuoti visą saugyklą
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Atsakomybės apribojimas**: **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, atkreipkite dėmesį, kad automatizuotuose vertimuose gali pasitaikyti klaidų ar netikslumų. Originalus dokumentas gimtąja kalba turėtų būti laikomas autoritetingu šaltiniu. Svarbiai informacijai rekomenduojama naudotis profesionalaus žmogaus vertimu. Mes neprisiimame atsakomybės už bet kokius nesusipratimus ar neteisingas interpretacijas, kylančias dėl šio vertimo naudojimo. Šis dokumentas buvo išverstas naudojant dirbtinio intelekto vertimo paslaugą [Co-op Translator](https://github.com/Azure/co-op-translator). Nors siekiame tikslumo, atkreipkite dėmesį, kad automatizuoti vertimai gali turėti klaidų arba netikslumų. Originalus dokumentas gimtąja kalba turėtų būti laikomas autoritetingu šaltiniu. Kritiniais atvejais rekomenduojama naudotis profesionalių žmonių vertimais. Mes neatsakome už bet kokius nesusipratimus ar neteisingas interpretacijas, kylančias iš šio vertimo naudojimo.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->

6
translations/my/.co-op-translator.json
Unescape View File

@ -1,7 +1,7 @@
{ {
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": { "1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8", "original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-06T17:02:28+00:00", "translation_date": "2026-03-27T22:58:54+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md", "source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "my" "language_code": "my"
}, },
@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T17:18:23+00:00", "translation_date": "2026-03-27T23:08:22+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "my" "language_code": "my"
}, },

868
translations/my/1-getting-started-lessons/1-intro-to-programming-languages/README.md
View File

File diff suppressed because it is too large Load Diff

365
translations/my/AGENTS.md
Unescape View File

@ -2,27 +2,27 @@
## Project Overview ## Project Overview
ဤအရာသည် ဝက်ဘ်ဖွံ့ဖြိုးတိုးတက်မှု အခြေခံများကို စတင္ရင်းနှီးသူများကို သင်ကြားပေးရန် ရည်ရွယ်ထားသော ပညာရေးသင်ရိုးအစီအစဉ်၏ ဂိုဒေါင်ဖြစ်သည်။ သင်ရိုးအစီအစဉ်သည် Microsoft Cloud Advocates များမှ ဖန်တီးထားသော ၁၂ အပတ် ကြာသည့် အဝန်းလည်းပြည့်သည့် သင်ခန်းစာများပါဝင်ပြီး JavaScript၊ CSS နှင့် HTML ကို လက်တွေ့ လေ့ကျင့်ခန်း ၂၄ ခုအပါအဝင်ဖြစ်သည်။ ဤသည်မှာ အခြေခံအဆင့် ဝက်ဘ် ဖွံ့ဖြိုးတိုးတက်မှုကို သင်ကြားရန် အတွက် ပညာရေး သင်ရိုးညွှန်းတမ်း သိမ်းဆည်းရာ ရှိသော repository ဖြစ်သည်။ သင်ရိုးညွှန်းတမ်းတွင် Microsoft Cloud Advocates မှ တီထွင်ထားသော ၁၂ ပတ်ကြာ သင်တန်းလုံလောက်ပြီး JavaScript, CSS နှင့် HTML ကို အကျဉ်းချုပ် ပါဝင်တဲ့ လက်တွေ့သင်ခန်းစာ ၂၄ ခု ပါဝင်သည်။
### Key Components ### Key Components
- **ပညာရေး အကြောင်းအရာ**: စီမံကိန်းအခြေခံ မော်ဂျူးများ အတွင်း ဖွဲ့စည်းထားသော ၂၄ ခု သင်ခန်းစာ - **ပညာရေး အကြောင်းအရာ**: ၂၄ ခုသော ဖွဲ့စည်းထားသော သင်ခန်းစာများကို ပရောဂျက်အခြေပြု ပုံစံဖြင့် စီစဉ်ထားသည်
- **လက်တွေ့ စီမံကိန်းများ**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, နှင့် AI Chat Assistant - **လက်တွေ့ ပရောဂျက်များ**: Terrarium၊ Typing Game၊ Browser Extension၊ Space Game၊ Banking App၊ Code Editor နှင့် AI Chat Assistant
- **အပြန်အလှန် စစ်ဆေးမေးခွန်းများ**: မေးခွန်း ၃ ခုနှင့် ၄၈ ခု (သင်ခန်းစာမတိုင်မှီ/ပြီးနောက်သုံးသပ်မှုများ) - **အပြန်အလှန် စစ်တမ်းများ**: သင်ခန်းစာနှင့် မတိုင်မှီ/နောက်ပိုင်း စစ်တမ်း ၄၈ ခု၊ မေးခွန်းသုံးခုစီပါဝင်သည်
- **ဘာသာစကား များစွာ ပံ့ပိုးမှု**: GitHub Actions မှတစ်ဆင့် ၅၀ ကျော်ဘာသာစကား အလိုအလျောက် ဘာသာပြန်ခြင်း - **ဘာသာစကား များစွာ ထောက်ခံမှု**: GitHub Actions ဖြင့် ၅၀ ကျော်သော ဘာသာစကားများအတွက် အလိုအလျောက် ဘာသာပြန်မှုများ
- **နည်းပညာများ**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI စီမံကိန်းများအတွက်) - **နည်းပညာများ**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI ပရောဂျက်များအတွက်)
### Architecture ### Architecture
- သင်ခန်းစာအခြေခံ ပညာရေးဂိုဒေါင် - သင်ခန်းစာအခြေပြု ပညာရေး repository
- သင်ခန်းစာတိုင်းတွင် README၊ ကုဒ်ဥပမာများနှင့် ဖြေရှင်းနည်းများပါဝင် - သင်ခန်းစာ folder တစ်ခုစီတွင် README, code ဥပမာများနှင့် ဖြေရှင်းချက်များ ပါဝင်သည်
- ကွဲပြားသော ဒိုင်ရေးတရီများတွင် သီးခြား စီမံကိန်းများ (quiz-app, သင်ခန်းစာစီမံကိန်းစွန့်) - quiz-app နှင့် အခြား သီးခြားပရောဂျက်များအတွက် အလွတ် directory များ
- GitHub Actions (co-op-translator) ကို အသုံးပြုသည့် ဘာသာပြန်စနစ် - GitHub Actions အသုံးပြုပြီး ဘာသာပြန် မော်ဒယ်စနစ် (co-op-translator)
- Docsify မှတဆင့် စာတမ်းများ ပေးပို့ပြီး PDF အဖြစ်ရနိုင်ခြင်း - Docsify အသုံးပြု၍ စာတမ်းရေးဆွဲမှု ပြုလုပ်ပြီး PDF အဖြစ် ရနိုင်သည်
## Setup Commands ## Setup Commands
ဤဂိုဒေါင်ကို အဓိကအားဖြင့် ပညာရေးအကြောင်းအရာ အသုံးပြုမှုနှင့် ရည်ရွယ်သည်။ သီးခြား စီမံကိန်းများတွင် အလုပ်လုပ်ရန်: ဤ repository သည် ပညာရေး အကြောင်းအရာ စမ်းသုံးခြင်း အထူးပြုထားသည်။ အထူးပရောဂျက်များနှင့် ဆောင်ရွက်ရန်အတွက် -
### Main Repository Setup ### Main Repository Setup
@ -36,9 +36,9 @@ cd Web-Dev-For-Beginners
```bash ```bash
cd quiz-app cd quiz-app
npm install npm install
npm run dev # ဖွံ့ဖြိုးမှုဆာဗာကို စတင်ပါ npm run dev # ဖွံ့ဖြိုးမှုဆာဗာစတင်ပါ
npm run build # ထုတ်လုပ်မှုအတွက် တည်ဆောက်ပါ npm run build # ထုတ်လုပ်မှုအတွက် ဆောက်လုပ်ပါ
npm run lint # ESLint ကို chạyပါ npm run lint # ESLint ကို chạy ပါ
``` ```
### Bank Project API (Node.js + Express) ### Bank Project API (Node.js + Express)
@ -48,7 +48,7 @@ cd 7-bank-project/api
npm install npm install
npm start # API ဆာဗာကို စတင်ပါ npm start # API ဆာဗာကို စတင်ပါ
npm run lint # ESLint ကို လုပ်ဆောင်ပါ npm run lint # ESLint ကို လုပ်ဆောင်ပါ
npm run format # Prettier ဖြင့် ဖော်မတ်လုပ်ပါ npm run format # Prettier ဖြင့် ဖော်မက် ပြုလုပ်ပါ
``` ```
### Browser Extension Projects ### Browser Extension Projects
@ -56,7 +56,7 @@ npm run format # Prettier ဖြင့် ဖော်မတ်လုပ်
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
npm install npm install
# ဘရောက်ဇာအထူးတိကျသော extension ပေါင်းထည့်နည်းလမ်းညွှန်များကိုလိုက်နာပါ # ဘရောက်ဇာအလိုက် ထပ်ဆောင်းပုံတင်ခြင်း လမ်းညွှန်ချက်များကိုလိုက်နာပါ
``` ```
### Space Game Projects ### Space Game Projects
@ -64,7 +64,7 @@ npm install
```bash ```bash
cd 6-space-game/solution cd 6-space-game/solution
npm install npm install
# index.html ကို browser တွင်ဖွင့်ပါ သို့မဟုတ် Live Server ကို အသုံးပြုပါ # index.html ကို browser မှာ ဖွင့်ပါ သို့မဟုတ် Live Server ကို အသုံးပြုပါ
``` ```
### Chat Project (Python Backend) ### Chat Project (Python Backend)
@ -72,7 +72,7 @@ npm install
```bash ```bash
cd 9-chat-project/solution/backend/python cd 9-chat-project/solution/backend/python
pip install openai pip install openai
# GITHUB_TOKEN ပတ်ဝန်းကျင်အပြောင်းအလဲအစားထိုးပြုလုပ်ရန် # GITHUB_TOKEN ပတ်ဝန်းကျင် သတ်မှတ်ချက်ကို သတ်မှတ်ပါ
python api.py python api.py
``` ```
@ -80,29 +80,29 @@ python api.py
### For Content Contributors ### For Content Contributors
1. သင့် GitHub အကောင့်သို့ လှည်းရိုက်ပါ 1. သင်၏ GitHub မှာ repository ကို **fork** ပြုလုပ်ပါ
2. သင့်လှည်းကို ဒေသခံတွင် ကွန်ပျူတာသို့ကလုဏ်းလုပ်ပါ 2. သင်၏ fork ကို လုပ်ဆောင်ရန် **clone** လုပ်ပါ
3. မိမိပြင်ဆင်မည့်အတွက် ဘရင့်အသစ်တစ်ခု ဖန်တီးပါ 3. ပြင်ဆင်မှုများအတွက် **branch အသစ်** ဖန်တီးပါ
4. သင်ခန်းစာအကြောင်းအရာ သို့မဟုတ် ကုဒ်ဥပမာများ ပြုပြင်ပါ 4. သင်ခန်းစာ အကြောင်းအရာ သို့မဟုတ် code ဥပမာများ ဆက်လက်ပြင်ဆင်ပါ
5. သင့်အပြောင်းအလဲများကို သက်ဆိုင်ရာ စီမံကိန်း ဒိုင်ရေးတရီများတွင် စမ်းသပ်ပါ 5. သက်ဆိုင်ရာ ပရောဂျက် directory များတွင် code ပြင်ဆင်မှုများ စမ်းသပ်ပါ
6. ထောက်ပံ့မှုလမ်းညွှန်များကို လိုက်နာ၍ Pull Request တင်ပါ 6. အညွှန်းလိုက်၍ pull request များတင်ပါ
### For Learners ### For Learners
1. ဂိုဒေါင်ကို လှည်းရိုက်သို့မဟုတ် ကလုဏ်းလုပ်ပါ 1. Repository ကို fork သို့မဟုတ် clone လုပ်ပါ
2. သင်ခန်းစာ ဒိုင်ရေးတရီများအား တစိတ်တပိုင်း နဲ့သွားပါ 2. သင်ခန်းစာ directory များကို အဆင့်လိုက် သွားပါ
3. သင်ခန်းစာတိုင်း၏ README ဖိုင်များ ဖတ်ပါ 3. တစ်ခုစီသင်ခန်းစာ README ဖတ်ပါ
4. https://ff-quizzes.netlify.app/web/ တွင် သင်ခန်းစာမတိုင်မှီ စစ်ဆေးမေးခွန်းများ ဖြေဆိုပါ 4. https://ff-quizzes.netlify.app/web/ တွင် သင်ခန်းစာ မတိုင်မှီ စစ်တမ်းများ ဖြေဆိုပါ
5. သင်ခန်းစာဒိုင်ရေးတရီများတွင် ကုဒ်ဥပမာများ အလုပ်လုပ်ပါ 5. သင်ခန်းစာ folder တွင် code ဥပမာများ လေ့လာပါ
6. အပ်စာများနှင့် စိန်ခေါ်မှုများ ပြီးစီးပါ 6. အလုပ်အပ်နှင့် စိန်ခေါ်မှုများ ပြီးမြောက်ပါ
7. သင်ခန်းစာပြီးနောက် စစ်ဆေးမေးခွန်းများ ဖြေဆိုပါ 7. သင်ခန်းစာ ပြီးနောက် စစ်တမ်းများ ဖြေဆိုပါ
### Live Development ### Live Development
- **စာတမ်းများ**: root မှ `docsify serve` အမိန့် ဖွင့်ပါ (port 3000) - **စာတမ်းရေးဆွဲခြင်း**: root တွင် `docsify serve` လုပ်ပါ (port 3000)
- **Quiz App**: quiz-app ဒိုင်ရေးတရီတွင် `npm run dev` ဖြင့် သက်ဝင်အောင်လုပ်ပါ - **Quiz App**: quiz-app directory တွင် `npm run dev` ပြုလုပ်ပါ
- **စီမံကိန်းများ**: HTML စီမံကိန်းများအတွက် VS Code Live Server extension အသုံးပြုပါ - **ပရောဂျက်များ**: HTML ပရောဂျက်များအတွက် VS Code Live Server extension အသုံးပြုပါ
- **API စီမံကိန်းများ**: သက်ဆိုင်ရာ API ဒိုင်ရေးတရီတွင် `npm start` ပြုလုပ်ပါ - **API ပရောဂျက်များ**: သက်ဆိုင်ရာ API directory တွင် `npm start` ပြုလုပ်ပါ
## Testing Instructions ## Testing Instructions
@ -110,85 +110,85 @@ python api.py
```bash ```bash
cd quiz-app cd quiz-app
npm run lint # ကုဒ်ပုံစံပြဿနာများကိုစစ်ဆေးပါ npm run lint # သို့သော် အညွှန်းစတိုင်ပြဿနာများကို စစ်ဆေးပါ
npm run build # ဆောက်လုပ်မှုအောင်မြင်မှုကိုအတည်ပြုပါ npm run build # ဆောက်လုပ်မှုအောင်မြင်သည်ကို အတည်ပြုပါ
``` ```
### Bank API Testing ### Bank API Testing
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm run lint # ကုဒ်ပုံစံပြဿနာများကိုစစ်ဆေးပါ npm run lint # ကုဒ်ပုံစံပြဿနာများကို စစ်ဆေးပါ
node server.js # ပြတ်မှုများမရှိဘဲ ဆာဗာစတင်မှုကိုအတည်ပြုပါ node server.js # အမှား မရှိဘဲ ဆာဗာ ချိန်ဆက်စတင်မှုကို အတည်ပြုပါ
``` ```
### General Testing Approach ### General Testing Approach
- ဤသည်မှာ စုံလုံသော အလိုအလျောက် စမ်းသပ်မှုများ မပါဝင်သည့် ပညာရေးဂိုဒေါင်ဖြစ်သည် - ဤသည်မှာ တိကျသော အလိုအလျောက် စမ်းသပ်မှု မပါဝင်သော ပညာရေး repository ဖြစ်သည်
- လက်တွေ့စမ်းသပ်မှုတွင် အာရုံစိုက်ရန် - လက်တို စမ်းသပ်မှုတွင် အောက်ပါအချက်များ အဓိကထားသည် -
- ကုဒ်ဥပမာများ အမှားမရှိပြေးနိုင်ခြင်း - Code ဥပမာများ အမှား မရှိစွာ လည်ပတ်ခြင်း
- စာတမ်း တွင် လင့်ခ်များ သင့်တော်စွာ လည်ပတ်ခြင်း - စာတမ်းရေးဆွဲမှု လင့်ခ်များ တိကျမှန်ကန်စွာ ဆက်သွယ်နိုင်ခြင်း
- စီမံကိန်း အောင်မြင်စွာ တည်ဆောက်ခြင်း - ပရောဂျက် တည်ဆောက်မှု အောင်မြင်စွာ ပြီးစီးခြင်း
- ဥပမာများသည် အကောင်းဆုံး လေ့လာသင်ယူနည်းများကို လိုက်နာခြင်း - ဥပမာများသည် အကောင်းဆုံးကွင်းဆက်နှင့် ကိုက်ညီမှု
### Pre-submission Checks ### Pre-submission Checks
- package.json ပါဝင်သည့် ဒိုင်ရေးတရီများတွင် `npm run lint` အလုပ်လုပ်ပါ - package.json ပါရှိသည့် directory များတွင် `npm run lint` လုပ်ပါ
- markdown link များ သေချာစွာ စစ်ဆေးပါ - markdown လင့်ခ်များမှန်ကန်မှု စစ်ဆေးပါ
- ကုဒ်ဥပမာများအား browser သို့မဟုတ် Node.js တွင် စမ်းသပ်ပါ - Browser သို့မဟုတ် Node.js တွင် code ဥပမာများ စမ်းသပ်ပါ
- ဘာသာပြန်မှုသိမ်းထားမှု တိကျမှန်ကန်ကြောင်း စစ်ဆေးပါ - ဘာသာပြန်မှုများ၏ ဖွဲ့စည်းမှု တိကျမှန်ကန်မှုစစ်ဆေးပါ
## Code Style Guidelines ## Code Style Guidelines
### JavaScript ### JavaScript
- ယနေ့ခေတ် ES6+ စတိုင်များ အသုံးပြုပါ - လက်ရှိ ES6+ စတိုင်သုံးရန်
- စီမံကိန်းများတွင် ပေးထားသော အခြေခံ ESLint ဖိုင်များကို လိုက်နာပါ - များသော project များတွင် ESLint configuration ကိုလိုက်နာရန်
- ပညာရေးအတွက် မျက်မှောက်နားလည်မှုလွယ်ကူရန် သေချာသည့် အမျိုးအမည်များ အသုံးပြုပါ - ပညာရေးအတွက် သင်အား လွယ်ကူစေရန် အဓိပ္ပါယ်ရှိ variable နဲ့ function နာမည်များသုံးရန်
- သင်ယူလိုသူများအတွက် အကြောင်းပြုချက်များ ထည့်သွင်းရေးသားပါ - သင်ကြားမှုအတွက် ကြားဖြတ်ချက်များ ထည့်ရန်
- Prettier ဖြင့် ပုံစံချိန်ညှိထားသောနေရာများတွင် အသုံးပြုပါ - Prettier ဖြင့် format ပြုလုပ်မှု (configuration ရှိသည့်နေရာတွင်)
### HTML/CSS ### HTML/CSS
- Semantic HTML5 အကြောင်းအရာအသုံးပြုပါ - Semantic HTML5 elements အသုံးပြုရန်
- ရွေ့လျားတုံ့ပြန်မှု ဒီဇိုင်း ကို ထည့်သွင်းပါ - Responsive ဒီဇိုင်း အခြေခံချက်များ
- ကလပ်အမည် များ ဖေါ်ပြပုံကွက်ကျစွာရေးသားပါ - သန့်ရှင်းပြီး ရှင်းလင်းသော class နာမည်များ
- CSS နည်းပညာများကို သင်ယူသူများအတွက် ရှင်းလင်းဖေါ်ပြမှု များ ထည့်ပါ - သင်သားများ အတွက် CSS နည်းပညာ ရှင်းလင်းပြောကြားမှုများ
### Python ### Python
- PEP 8 စတိုင် လမ်းညွှန်များ လိုက်နာပါ - PEP 8 စတိုင်လ်လမ်းညွှန်များ
- ပညာရေးအတွက် သေချာရှင်းလင်းသော ကုဒ်ဥပမာများ - သင်ထောက်အကူဖြစ်သော ကျယ်ပြန့်သော code ဥပမာများ
- သင်ယူမှုအတွက် အထောက်အကူဖြစ်စေရန် Type hints အသုံးပြုပါ - အသုံးပြုသူအတွက် အကူအညီဖြစ်မည့် Type hints ထည့်သုံးရန်
### Markdown Documentation ### Markdown Documentation
- ခေါင်းစဉ်များ ဖော်ပြမှု တိကျရှင်းလင်းမှု - ရှင်းရှင်းလင်းလင်း ခေါင်းစဉ်အဆင့်ခွဲခြားမှု
- ဘာသာပြန်ဖြစ်သည့် ကုဒ်ဘလော့များနှင့် ဘာသာဖော်ပြမှု - ဘာသာပြန်သည့် language နဲ့ code-block များ
- အပိုဆောင်း ရင်းမြစ်များအား လင့်ခ်များပါဝင်သည် - အပိုဆောင်းအရင်းအမြစ် သွားရောက်ရန် link များ
- `images/` ဒိုင်ရေးတရီပြည့်စုံအပါအဝင် ပုံများနှင့် ရုပ်ပုံများ - `images/` folder များရှိ screenshot နှင့် ပုံများ
- အားလုံးလက်လှမ်းမီစေရန် ဗဟိုသတ်မှတ် Alt texts များ - ပုံများအတွက် accessibility အတွက် Alt text ထည့်ရန်
### File Organization ### File Organization
- သင်ခန်းစာများကို တန်းတူ နေရာချထားမှု (1-getting-started-lessons, 2-js-basics, စသည်) - သင်ခန်းစာများကို နံပါတ်စဉ်လိုက် ဖြစ်ရန် (1-getting-started-lessons, 2-js-basics စသဖြင့်)
- စီမံကိန်းတိုင်းတွင် `solution/` နှင့် မကြာခဏ `start/` သို့မဟုတ် `your-work/` ဒိုင်ရေးတရီများရှိသည် - project အသီးသီးတွင် `solution/` နှင့် မကြာခဏ `start/` သို့မဟုတ် `your-work/` directory များရှိသည်
- သင်ခန်းစာအလိုက် `images/` ဖိုလ်ဒါထဲတွင် ပုံများ သိုလှောင်ထားခြင်း - ပုံများကို သင်ခန်းစာအလိုက်သိုလှောင်ထားသော `images/` folder တွင်ရှိသည်
- ဘာသာပြန်များကို `translations/{language-code}/` ဖိုလ်ဒါတွင် သိမ်းဆည်းထားခြင်း - ဘာသာပြန်ဖိုင်များကို `translations/{language-code}/` structure ဖြင့်ထားသည်
## Build and Deployment ## Build and Deployment
### Quiz App Deployment (Azure Static Web Apps) ### Quiz App Deployment (Azure Static Web Apps)
quiz-app သည် Azure Static Web Apps များတွင် တည်ဆောက်ရန် စံချိန်တင်ထားသည်- quiz-app ကို Azure Static Web Apps deployment အတွက် တပ်ဆင်ထားသည် -
```bash ```bash
cd quiz-app cd quiz-app
npm run build # dist/ ဖိုလဒါကို ဖန်တီးသည် npm run build # dist/ ဖိုလ်ဒါကို ဖန်တီးသည်
# main တွင် push လုပ်သည့်အခါ GitHub Actions workflow ဖြင့် Deploy လုပ်သည် # main သို့ push လုပ်သောအခါ GitHub Actions workflow မှတဆင့် တင်ပို့သည်
``` ```
Azure Static Web Apps စနစ်ဖောင့်ကွက်များ- Azure Static Web Apps configuration:
- **App location**: `/quiz-app` - **App location**: `/quiz-app`
- **Output location**: `dist` - **Output location**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
@ -196,86 +196,87 @@ Azure Static Web Apps စနစ်ဖောင့်ကွက်များ-
### Documentation PDF Generation ### Documentation PDF Generation
```bash ```bash
npm install # docsify-to-pdf ကို ထည့်သွင်းပါ npm install # docsify-to-pdf ကို 설치 하십시오
npm run convert # docs မှ PDF ကို ဖန်တီးပါ npm run convert # docs မှ PDF ကို 생성하십시오
``` ```
### Docsify Documentation ### Docsify Documentation
```bash ```bash
npm install -g docsify-cli # Docsify ကို စုစုပေါင်း ထည့်သွင်းပါ npm install -g docsify-cli # Docsify ကို ကမ္ဘာလုံးဆိုင်ရာ ထည့်သွင်းပါ
docsify serve # localhost:3000 တွင် ဝန်ဆောင်မှုပေးပါ docsify serve # localhost:3000 တွင် စနစ်ဆောင်ပါ
``` ```
### Project-specific Builds ### Project-specific Builds
စီမံကိန်းတိုင်းတွင် ကိုယ်ပိုင် တည်ဆောက်မှု လုပ်ငန်းစဉ်များ ရှိနိုင်သည်- ပရောဂျက် directory တစ်ခုချင်းစီတွင် build လုပ်ငန်းစဉ် များလည်း ရှိနိုင်သည် -
- Vue စီမံကိန်းများ: `npm run build` ဖြင့် ထုတ်လုပ်မှု bundle များ ပြုလုပ်ခြင်း - Vue ပရောဂျက်များ: `npm run build` မှာ production bundle များဖန်တီးသည်
- Static စီမံကိန်းများ: တည်ဆောက်မှုပြုလုပ်မှု လိုအပ်မှု မရှိပါ၊ ဖိုင်များကို တိုက်ရိုက် ဝန်ဆောင်မှုပေးခြင်း - Static ပရောဂျက်များ: build လုပ်ရန် မလိုအပ်ပါ၊ ဖိုင်များကိုတန်းတူ serve ပြုလုပ်သည်
## Pull Request Guidelines ## Pull Request Guidelines
### Title Format ### Title Format
ပြောင်းလဲမှု နေရာအတိုင်း ဖြည့်သွင်းဖေါ်ပြရန်- ပြင်ဆင်မှု လုပ်ဆောင်သော နေရာကို ပြသသည့် ရှင်းလင်းအသိပေးခေါင်းစဉ်များ၌ များသုံးရန် -
- `[Quiz-app] သင်ခန်းစာ X အတွက် Quiz အသစ် ထည့်ရန်` - `[Quiz-app] သင်ခန်းစာ X အတွက် quiz အသစ်ထည့်ပါ`
- `[Lesson-3] Terrarium စီမံကိန်းတွင် အမှားစာလုံးပြင်ဆင်ခြင်း` - `[Lesson-3] terrarium ပရောဂျက်တွင် အမှားတစ်ခု ပြင်ဆင်ပါ`
- `[Translation] သင်ခန်းစာ ၅ အတွက် စပိန်ဘာသာပြန်ထည့်ခြင်း` - `[Translation] သင်ခန်းစာ ၅ အတွက် စပိန်ဘာသာ ပြန်တင်ဘှဲ့ပါ`
- `[Docs] Setup လမ်းညွှန်ချက်များ ပြင်ဆင်ခြင်း` - `[Docs] Setup အဆင့်ညွှန်ကြားချက်များ အပ်ဒိတ်ပြုလုပ်ပါ`
### Required Checks ### Required Checks
PR တင်ပြီးမတိုင်မီ- PR တင်မည့်အချိန် မတိုင်မီ -
1. **ကုဒ်အရည်အသွေး**: 1. **Code ပြည့်စုံမှု**
- သက်ဆိုင်ရာ စီမံကိန်း ဒိုင်ရေးတရီတွင် `npm run lint` ကို အသုံးပြု၍ အမှားများ ဖော်ထုတ်ရန် - သက်ဆိုင်ရာ project directory များတွင် `npm run lint` ကို လုပ်ပါ
- လုံးလုံးမကျန် အမှား နှင့် သတိပေးချက် များ ပြင်ဆင်ပါ - အမှားများနှင့် အသိပေးချက်များကို ပြင်ဆင်ပါ
2. **တည်ဆောက်မှု စစ်ဆေးခြင်း**: 2. **Build စစ်ဆေးခြင်း**
- `npm run build` (လိုအပ်ပါက) အလုပ်လုပ်၍ အမှားမရှိစေရန် - လိုအပ်ပါက `npm run build` ပြုလုပ်ပါ
- build အမှား မရှိပါစေ
3. **လင့်ခ် စစ်ဆေးမှု**: 3. **Link စစ်ဆေးခြင်း**
- markdown link များအားလုံး ရှင်းလင်းမှန်ကန်စွာ လည်ပတ်ခြင်း - Markdown လင့်ခ်များအားလုံးကို စမ်းသပ်ပါ
- ဓာတ်ပုံ နှင့် ရုပ်ပုံများ ရောက်ရှိမှု - ဓာတ်ပုံများ ရှိမရှိ စစ်ဆေးပါ
4. **အကြောင်းအရာ ပြန်လည် သုံးသပ်ခြင်း**: 4. **အကြောင်းအရာ စစ်တမ်း**
- စကားလုံးမှား၊ သဒ္ဒါမှားများကို စစ်ချက်ပေးခြင်း - စာလုံးပျက်မှားနှင့် သဒ္ဒါ အမှား မရှိစေရန် စစ်ဆေးပါ
- ကုဒ်ဥပမာများ သင်ယူရန်တိကျမှန်ကန်စွာ ရှိခြင်း - Code ဥပမာများ မှန်ကန်ပြီး သင်ကြားမှုရှိစေရန် စစ်ဆေးပါ
- ဘာသာပြန်များသည် မူလ အဓိပ္ပါယ်ကို ထိန်းသိမ်းထားခြင်း - ဘာသာပြန်မှုများ အဓိပ္ပါယ်မပြောင်းဘဲ တိကျမှုရှိစေရန် စစ်ဆေးပါ
### Contribution Requirements ### Contribution Requirements
- Microsoft CLA ကို သဘောတူပါ (PR ပထမဆုံးပြုလုပ်ချိန် တွင် အလိုအလျောက် စစ်ဆေးမည်) - Microsoft CLA ကို သဘောတူရပါမည် (ပထမ PR တွင် အလိုအလျောက် စစ်ဆေးသည်)
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) လိုက်နာပါ - [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ကို နောက်ဆုံးလိုက်နာရမည်
- အသေးစိတ် လမ်းညွှန်ချက်များအတွက် [CONTRIBUTING.md](./CONTRIBUTING.md) ကို ကြည့်ပါ - အသေးစိတ်အတွက် [CONTRIBUTING.md](./CONTRIBUTING.md) ကို ကြည့်ပါ
- PR ဖေါ်ပြချက်တွင် လိုအပ်ပါက ရှေ့ပြေး ဥပဒေအမှတ်များကို ထည့်သွင်းပါ - PR ဖေါ်ပြချက်တွင် issue နံပါတ်များကို ရည်ညွှန်းပါ
### Review Process ### Review Process
- PR များသည် ပြုပြင်သူများနှင့် မိသားစုအသိုင်းအဝိုင်း အကြား ကြည့်သုံးစစ်ဆေးခြင်း - PR များသည် Maintainer များနှင့် အသိုင်းအဝိုင်းအားဖြင့် စစ်ဆေးသည်
- ပညာရေး ရည်ရွယ်ချက် ဦးစားပေး စစ်ဆေးခြင်း - ပညာရေး ရှင်းလင်းမှုကို အလေးထားသည်
- ကုဒ်ဥပမာများသည် လောလောဆယ် အကောင်းဆုံး လေ့လာသင်ယူနည်းများနှင့် ကိုက်ညီစေရန် - Code ဥပမာများသည် လက်ရှိအကောင်းဆုံးနည်းလမ်းများနှင့် မညီမှု မရှိစေရန် ကြိုတင်စစ်ဆေးသည်
- ဘာသာပြန်အရည်အသွေးနှင့် ယဉ်ကျေးမှု သင်္ကေတတပ်ဖွဲ့မှု ရှိအောင် စစ်ဆေးခြင်း - ဘာသာပြန်မှုများအား တိကျမှုနှင့် ယဉ်ကျေးမှုအရ သက်ဆိုင်မှုရှိစေရန် ပြန်လည်သုံးသပ်သည်
## Translation System ## Translation System
### Automated Translation ### Automated Translation
- GitHub Actions တွင် နေရာယူထားသည့် co-op-translator workflow ကို အသုံးပြုသည် - GitHub Actions သုံးပြီး co-op-translator workflow အသုံးပြုသည်
- ၅၀ ကျော်ဘာသာစကားသို့ အလိုအလျောက် ဘာသာပြန်သည် - ၅၀ ကျော်သော ဘာသာစကားများအတွက် အလိုအလျောက် ဘာသာပြန်ပေးသည်
- မူရင်းဖိုင်များသည် မူလ ဒိုင်ရေးတရီများတွင် - မူလဖိုင်များသည် main directory များတွင်ရှိသည်
- ဘာသာပြန်ထားသောဖိုင်များသည် `translations/{language-code}/` တွင် - ဘာသာပြန်ထားသော ဖိုင်များကို `translations/{language-code}/` ထဲတွင် သိမ်းဆည်းထားသည်
### Adding Manual Translation Improvements ### Adding Manual Translation Improvements
1. `translations/{language-code}/` တွင် ဖိုင် ရှာပါ 1. `translations/{language-code}/` တွင် ဖိုင်များကို ရှာတွေ့ပါ
2. ဖွဲ့စည်းပုံကို ထိန်းသိမ်းပြီး တိုးတက်အောင် ပြုပြင်ပါ 2. ဖွဲ့စည်းမှုမပြောင်းလဲဘဲ တိုးတက်မှုများ ပြုလုပ်ပါ
3. ကုဒ်ဥပမာများ အသုံးပြုနိုင်မှု ရှိသည်ကို သေချာစေရန် 3. Code ဥပမာများ မပျက်မကွက် ဆက်လက်လုပ်ဆောင်နိုင်စေရန် သတိပြုပါ
4. ဒေသဆိုင်ရာ Quiz အကြောင်းအရာ စမ်းသပ်ပါ 4. ညှိနှိုင်းထားသော Quiz အကြောင်းအရာ များကို စမ်းသပ်ပါ
### Translation Metadata ### Translation Metadata
ဘာသာပြန် ဖိုင်များတွင် metadata ခေါင်းစဉ်ပါရှိသည်- ဘာသာပြန် ဖိုင်များတွင် မီတာဒေတာ ခေါင်းစီးပါဝင်သည် -
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -292,116 +293,116 @@ CO_OP_TRANSLATOR_METADATA:
### Common Issues ### Common Issues
**Quiz app မတက်အောင် ရှုပ်ထွေးမှုများ**: **Quiz app တက်ရန် မအောင်မြင်ခြင်း**:
- Node.js ဗားရှင်း (v14+ အကြံပြု) - Node.js ဗားရှင်း (v14+) ကို စစ်ဆေးပါ
- `node_modules` နှင့် `package-lock.json` ဖိုင်များ ဖျက်ပြီး `npm install` ပြန်လည်ပြုလုပ်ပါ - `node_modules` နှင့် `package-lock.json` ဖိုင်များ ဖျက်ပြီး `npm install` ပြန်တင်ပါ
- Vite သည် အခြား port 5173 ကိုသုံးပြီး ရပ်တန့်မှုရှိမရှိ စစ်ဆေးပါ - Port ပိုင်း ယှဉ်ပြိုင်မှုရှိနိုင်မရှိ စစ်ဆေးပါ (default: Vite သည် port 5173 သုံးသည်)
**API server မစခင်**: **API server မတက်ခြင်း**:
- Node.js ဗားရှင်း (node >=10) ဖြစ်ကြောင်း အတည်ပြုပါ - Node.js ဗားရှင်းအနည်းဆုံး node >=10 ဖြစ်မဖြစ် စစ်ဆေးပါ
- Port လုပ်ဆောင်မှု ရှိ/မရှိ စစ်ပါ - Port သုံးနေခြင်း ရှိမရှိ စစ်ဆေးပါ
- `npm install` ဖြင့် အားလုံး dependency များထည့်သွင်းထားခြင်း - `npm install` ဖြင့် အားလုံး dependencies ထည့်သွင်းထားခြင်း စစ်ဆေးပါ
**Browser extension မတက်တာ**: **Browser extension မတက်ခြင်း**:
- manifest.json အသေးစိတ် ပုံစံ မှန်ကန်မှု စစ်ဆေးပါ - manifest.json ဖိုင် format မှန်ကန်မှုစစ်ပါ
- Browser console တွင် အမှား ရှိ မရှိ စစ်ပါ - Browser console တွင် အမှားများရှိမရှိ စစ်ဆေးပါ
- Browser-specific extension installation လမ်းညွှန်ချက်များ လိုက်နာပါ - Browser အလိုက် extension ထည့်သွင်းနည်းများ လိုက်နာပါ
**Python chat project ပြဿနာများ**: **Python chat project အခက်အခဲများ**:
- OpenAI package ကို ထည့်သွင်းထားခြင်း - `pip install openai` - OpenAI package ထည့်သွင်းထားၿပီးဖြစ်စေရန် `pip install openai`
- GITHUB_TOKEN environment variable မှန်ကန်စွာ သတ်မှတ်ထားခြင်း - GITHUB_TOKEN environment variable ဖော်ပြထားရေးစစ်ပါ
- GitHub Models ၏ လုပ်ဆောင်ခွင့် ရှိစေရန် စစ်ဆေးပါ - GitHub Models အသုံးခွင့်ရှိရေးစစ်ဆေးပါ
**Docsify docs မပေးဆောင်တာ**: **Docsify က စာတမ်း မတက်ခြင်း**:
- docsify-cli ကို ကမ္ဘာလုံးဆိုင်ရာ ထည့်သွင်းထားရန် - `npm install -g docsify-cli` - 글로벌အဆင့် docsify-cli ထည့်သွင်းရန် `npm install -g docsify-cli`
- ဂိုဒေါင် root ဒိုင်ရေးတရီမှ မိမိ အမိန့်ပြုလုပ်ပါ - Repository ရဲ့ root directory မှ စတင်ပါ
- `docs/_sidebar.md` ရှိ/မရှိ စစ်ဆေးပါ - `docs/_sidebar.md` ရှိမရှိ စစ်ဆေးပါ
### Development Environment Tips ### Development Environment Tips
- VS Code Live Server extension ဖြင့် HTML စီမံကိန်းများ အတွက် အသုံးပြုပါ - HTML project များအတွက် VS Code Live Server extension အား အသုံးပြုပါ
- ESLint နှင့် Prettier extension များ ထည့်သွင်းပါ - ESLint နှင့် Prettier extension များ ထည့်သွင်းထားပြီး ဖြည်းညည်းစွာ format ပြုလုပ်ပါ
- Browser DevTools ဖြင့် JavaScript နဲ့အတူ debugging လုပ်ပါ - JavaScript debugging အတွက် browser DevTools ကို အသုံးပြုပါ
- Vue စီမံကိန်းများအတွက် Vue DevTools browser extension ထည့်သွင်းပါ - Vue project များအတွက် Vue DevTools browser extension ထည့်သွင်းပါ
### Performance Considerations ### Performance Considerations
- ဘာသာပြန်ဖိုင် အရေအတွက် မာနကျွန်းကြီး ဖြစ်လို့ (၅၀+ ဘာသာစကား) full clone များ ကြီးတယ် - ဘာသာပြန်ဖိုင် အရေအတွက် များ (၅၀ ကျော် ဘာသာစကား) ဖြစ်သောကြောင့် full clone များ ကြီးမားသည်
- အချက်အလက်များပဲ အလုပ်လုပ်မည်ဆို shallow clone ကို အသုံးပါ - `git clone --depth 1` - အကြောင်းအရာသာ အလုပ်လုပ်မည့်အခါ shallow clone (`git clone --depth 1`) အသုံးပြုပါ
- အင်္ဂလိပ်အကြောင်းအရာတွင် လုပ်နေစဉ် ဘာသာပြန်များကို ရှာဖွေမှုမှ ထုတ်ပယ်ပါ - English အကြောင်းအရာ နှင့်အလုပ်လုပ်သောအခါ ဘာသာပြန် ဖိုင်များကို ရှာဖွေနေရာမှ ဖယ်ရှားပါ
- ပထမဆုံးအသုံးပြုမှုတွင် build လုပ်ခြင်းဟာ ကြာမြင့်နိုင်သည် (npm install, Vite build) - npm install, Vite build စသည့် စွမ်းဆောင်ရည်တွေ ပထမဆုံးပြေးတဲ့အချိန် စို့မြန်မှု နည်းနိုင်သည်
## Security Considerations ## Security Considerations
### Environment Variables ### Environment Variables
- API keys ကို ဂိုဒေါင်ထဲ မထည့်သွင်းကြပါနှင့် - API keys မည်သည့် အချိန်မှ repository ထဲ မသိမ်းဆည်းရ
- `.env` ဖိုင်များကို အသုံးပြုပါ (.gitignore ထဲတွင် ပါရှိပြီး) - `.env` ဖိုင်များကို အသုံးပြုပါ (ပြီးသား `.gitignore` ထဲမှာ ပါရှိ)
- စီမံကိန်း README များတွင် လိုအပ်သည့် Environment Variables များ ဖော်ပြပါ - Project README မှာ လိုအပ်သော environment variables များ ဖော်ပြထားပါ
### Python Projects ### Python Projects
- virtual environments အသုံးပြုပါ - `python -m venv venv` - virtual environments အသုံးပြုပါ: `python -m venv venv`
- dependency များကို အသစ်တင် ကျင်းပပေးပါ - dependencies များ ကိုပုံမှန် update လုပ်ပါ
- GitHub tokens များသည် လိုအပ်သော မူလ ခွင့်ပြုချက်များသာရှိစေရန် - GitHub tokens များတွင် လိုအပ်တဲ့ ခွင့်ပြုချက် အနည်းဆုံးပဲ သတ်မှတ်ထားပါ
### GitHub Models Access ### GitHub Models Access
- GitHub Models အတွက် Personal Access Tokens (PAT) လိုအပ်သည် - GitHub Models အသုံးပြုရန် Personal Access Tokens (PAT) လိုအပ်သည်
- ကုဒ်များကို environment variables အဖြစ် သိမ်းဆည်းထားပါ - Tokens များကို environment variables အဖြစ် သိမ်းဆည်းပါ
- Tokens သို့မဟုတ် လျှို့ဝှက်ချက်များကို ရိုးရိုး GitHub repo ထဲ မသိမ်းပါနှင့် - Tokens သို့မဟုတ် credentials မဖြန့်ဝေပါနှင့်
## Additional Notes ## Additional Notes
### Target Audience ### Target Audience
- ဝက်ဘ်ဖွံ့ဖြိုးမှု စပြိုင်သူ အသစ်များအတွက် - ဝက်ဘ် ဖွံ့ဖြိုးတိုးတက်မှု အစစ်အပိုင်းက စတင်လေ့လာသူများ
- ကျောင်းသားများနှင့် ကိုယ်တိုင် သင်ယူလိုသူများ - ကျောင်းသားများနှင့် ကိုယ်တိုင် လေ့လာသူများ
- သင်တန်းဆရာများ သင်တန်းတွင် အသုံးပြုရန် - သင်တန်းခန်းများတွင် သင်ကြားသူများ
- မည်သူ့အတွက်မျှ ဝင်ရောက်လွယ်ကူစေနိုင်တယ်၊ တန်ဖိုးရှိစွာ ကျွမ်းကျင်မှု တိုးတတ်အောင် ဆောင်ရွက်ခြင်း - အသုံးပြုရ လွယ်ကူပြီး တန်းတူဖြိုးတိုးမှု အတွက် အကြောင်းအရာများ ပါဝင်သည်
### Educational Philosophy ### Educational Philosophy
- စီမံကိန်းအခြေခံ သင်ယူမှု နည်းစနစ် - ပရောဂျက်အခြေပြု သင်ယူခြင်း
- မကြာခဏ အသိပညာ စစ်ဆေးမှုများ (quiz များ) - မကြာခဏ အသိပညာ စစ်တမ်းများ (quiz)
- လက်တွေ့ သင်ကြားရေး ရေးသားကိုယ်တိုင်လုပ်ခြင်း - လက်တွေ့ coding လေ့ကျင့်ခန်းများ
- အမှန်တကယ် အသုံးချနိုင်သော ဥပမာများ - အပြင်လောက သုံးသပ်မှု ဥပမာများ
- Framework များ မသတ်မှတ်ခင် အခြေခံကို အလေးထား ဆောင်ရွက်ခြင်း - Framework မတိုင်မှီ အခြေခံကို အလေးပေးခြင်း
### Repository Maintenance ### Repository Maintenance
- လေ့လာသူများနှင့် ပံ့ပိုးသူများ၏ လှုပ်ရှားမှု မြင့်မားခြင်း - လေ့လာသူများနှင့် ပံ့ပိုးသူများ၏ ပြန်လည်ဆွေးနွေးမှုရှိသော လူ့အသိုင်းအဝိုင်း တက်ကြွကောင်းမွန်သည့် အခြေအနေ
- dependency များနှင့် အကြောင်းအရာများအား ပုံမှန် အပ်ဒိတ်လုပ်ခြင်း - dependencies နှင့် အကြောင်းအရာများ ဆက်လက် update လုပ်ဆောင်ခြင်း
- ပြဿနာများနှင့် ဆွေးနွေးချက်များကို အသိအမှတ်ပြုသူများက လိုက်ပါစောင့်ကြည့်ခြင်း - Issue များနှင့် ဆွေးနွေးမှု များကို Maintainer များ ကြီးကြပ်စောင့်ရှောက်ခြင်း
- ဘာသာပြန်အပ်ဒိတ်များ ကို GitHub Actions အလိုအလျောက် ပြုလုပ်ခြင်း - ဘာသာပြန်ချက် update များကို GitHub Actions ဖြင့် အလိုအလျောက် ပြုလုပ်ခြင်း
### Related Resources ### Related Resources
- [Microsoft Learn modules](https://docs.microsoft.com/learn/) - [Microsoft Learn modules](https://docs.microsoft.com/learn/)
- [Student Hub resources](https://docs.microsoft.com/learn/student-hub/) - [Student Hub resources](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) ကို သင်ယူသူများအတွက် အကြံပြုပါသည် - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) သည် လေ့လာသူများအတွက် အကြံပြုသည်
- အပိုသင်တန်းများ: Generative AI, Data Science, ML, IoT သင်ရိုးအစီအစဉ်များ ရရှိနိုင်သည် - အပိုဆောင်းသင်တန်းများ: Generative AI, Data Science, ML, IoT သင်ရိုးညွှန်းတမ်းများ လည်း ရရှိနိုင်သည်
### Working with Specific Projects ### Working with Specific Projects
တစ်ဦးချင်းစီ စီမံကိန်းများအတွက် အသေးစိတ် ဖော်ပြချက်များကို README ဖိုင်များတွင် ကြည့်ရှုနိုင်ပါသည်- ပရောဂျက်အသီးသီးတွင် အသေးစိတ်ညွှန်ကြားချက်များအတွက် သက်ဆိုင်ရာ README ဖိုင်များကို ကြည့်ပါ -
- `quiz-app/README.md` - Vue 3 quiz အပ်လီကေးရှင်း - `quiz-app/README.md` - Vue 3 quiz application
- `7-bank-project/README.md` - အခြေခံအတည်ပြုမှု ပါဝင်သည့် ဘဏ်လုပ်ငန်း အက်ပ် - `7-bank-project/README.md` - Authentication နှင့် ထည့်သွင်းထားသော Banking application
- `5-browser-extension/README.md` - Browser extension ဖန်တီးခြင်း - `5-browser-extension/README.md` - Browser extension တည်ဆောက်ခြင်း
- `6-space-game/README.md` - ကမ်းဗတ်အခြေခံ ဂိမ်းဖန်တီးခြင်း - `6-space-game/README.md` - Canvas အခြေပြု ကစားပွဲ ဖန်တီးခြင်း
- `9-chat-project/README.md` - AI စကားပြော အကူအညီ နှင့် ဆော့ဖ်ဝဲ - `9-chat-project/README.md` - AI chat assistant project
### Monorepo Structure ### Monorepo Structure
ယခု ဂိုဒေါင်သည် စံထုံးမရှိသော်လည်း သီးခြား စီမံကိန်းများများ ပါဝင်သည်- ဒီ repository သည် ယေဘုယျ monorepo မဟုတ်ပေမယ့် ပရောဂျက်အမျိုးမျိုး ဦးတည်ထားသည် -
- သင်ခန်းစာ တစ်ခုချင်းစီသည် ကိုယ်ပိုင် အပိုင်းဖြစ်သည် - သင်ခန်းစာ တစ်ခုချင်းစီကို မတူညီပဲ သီးခြားထားသည်
- စီမံကိန်းများက dependency များ မမျှဝေပဲ သီးခြားလုပ်ဆောင်ထားသည် - ပရောဂျက်များသည် dependencies များ မမျှဝေကြ
- တစ်စီတစ်ရာ အပေါ် မသက်ရောက်စေရန် သီးခြားစီမံကိန်းများကို လုပ်ဆောင်နိုင်သည် - တစ်ခုတည်းသော ပရောဂျက်ကို ပြင်ဆင်ခြင်းသည် အခြားများအား ထိခိုက်မှု မရှိစေရန် ဖြစ်သည်
- အပြည့်အစုံသော သင်ရိုးကို အတွေ့အကြုံယူရန် ဂိုဒေါင်တခုလုံးကို clone လုပ်ပါ။ - အတူတကွ သင်ရိုးပုံစံ အပြည့်အဝကို ထည့်သွင်းဖို့အတွက် repository များကို စုပေါင်း clone လုပ်နိုင်သည်
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**သတိပြုချက်** **ကြွင်းချက်**:
ဤစာရွက်ကို AI ဘာသာပြန်ခြင်းဆော့ဖ်ဝဲဖြစ်သော [Co-op Translator](https://github.com/Azure/co-op-translator) ဖြင့် ဘာသာပြန်ထားပါသည်။ ကျွန်ုပ်တို့သည်တိကျမှန်ကန်မှုအတွက် ကြိုးပမ်းနေသော်လည်း အလိုအလျောက် ဘာသာပြန်ခြင်းတွင် အမှားများ သို့မဟုတ် မှားယွင်းချက်များ ရှိနိုင်သည်ကို သိရှိထားရန် မေတ္တာရပ်ခံအပ်ပါသည်။ မူရင်းစာရွက်ကို မူလဘာသာဖြင့်သာ မှန်ကန်သည့် မူရင်းအရင်းအမြစ်အဖြစ်ယူဆသင့်ပါသည်။ အရေးကြီးသည့် သတင်းအချက်အလက်များအတွက် ကျွမ်းကျင်သော လူသားဘာသာပြန်မှုကို အကြံပြုပါသည်။ ဤဘာသာပြန်ချက်ကို အသုံးပြုမှုကြောင့် ဖြစ်ပေါ်လာသော မည်သည့် ပဋိပက္ခ သို့မဟုတ် မှားနေမှုများအတွက် ကျွန်ုပ်တို့သည် တာဝန်မကောက်ခံပါ။ ဤစာရွက်ကို AI ဘာသာပြန်စနစ်ဖြစ်သော [Co-op Translator](https://github.com/Azure/co-op-translator) ကို အသုံးပြု၍ ဘာသာပြန်ထားပါသည်။ ကျွန်ုပ်တို့သည် မှန်ကန်မှုအတွက် ကြိုးစားနေသော်လည်း၊ အလိုအလျောက် ဘာသာပြန်ခြင်းကြောင့် အမှားများ သို့မဟုတ် မှန်ကန်မှုလျော့ပါးမှုများရှိနိုင်ကြောင်း သိရှိထားပေးပါ။ မူရင်းစာရွက်ကို မူလဘာသာဖြင့် တရားဝင်အရင်းအမြစ်အဖြစ် သတ်မှတ်သင့်ပါသည်။ အရေးကြီးသည့် သတင်းအချက်အလက်များအတွက် မူရင်း စာသားအရ ပြည့်စုံသော လူမှု့ဘာသာပြန်သား အတတ်ပညာရှင်တွေ ရရှိရန် အကြံပြုပါသည်။ ဤဘာသာပြန်မှုအသုံးပြုမှုကြောင့် ဖြစ်ပေါ်နိုင်သည့် နားလည်မှုအမှားများ သို့မဟုတ် ကန့်သတ်ချက်များအတွက် ကျွန်ုပ်တို့ တာဝန်မယူပါ။
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->

6
translations/uk/.co-op-translator.json
Unescape View File

@ -1,7 +1,7 @@
{ {
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": { "1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8", "original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-06T17:09:40+00:00", "translation_date": "2026-03-27T23:02:16+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md", "source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "uk" "language_code": "uk"
}, },
@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T17:19:32+00:00", "translation_date": "2026-03-27T23:09:23+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "uk" "language_code": "uk"
}, },

712
translations/uk/1-getting-started-lessons/1-intro-to-programming-languages/README.md
View File

File diff suppressed because it is too large Load Diff

426
translations/uk/AGENTS.md
Unescape View File

@ -2,27 +2,27 @@
## Огляд проекту ## Огляд проекту
Це навчальний репозиторій з курикулумом для викладання основ веб-розробки початківцям. Курикулум — це всебічний 12-тижневий курс, розроблений Microsoft Cloud Advocates, що містить 24 практичні уроки з JavaScript, CSS та HTML. Це навчальний репозиторій курсу для викладання основ веб-розробки початківцям. Курс є комплексним 12-тижневим навчальним планом, розробленим Microsoft Cloud Advocates, що включає 24 практичні уроки з JavaScript, CSS та HTML.
### Ключові компоненти ### Ключові компоненти
- **Навчальний контент**: 24 структуровані уроки, організовані в модулі на основі проектів - **Навчальний контент**: 24 структуровані уроки, організовані у модулі на основі проектів
- **Практичні проекти**: Terrarium, Typing Game, Розширення браузера, Space Game, Банківський додаток, Редактор коду та AI чат-асистент - **Практичні проекти**: Терраріум, Мережна гра, Розширення для браузера, Космічна гра, Банківський додаток, Редактор коду та AI чат-асистент
- **Інтерактивні вікторини**: 48 вікторин по 3 питання в кожній (до та після уроку) - **Інтерактивні тести**: 48 тестів по 3 питання кожен (до/після уроку)
- **Підтримка кількох мов**: Автоматичні переклади понад 50 мов за допомогою GitHub Actions - **Підтримка багатьох мов**: Автоматичний переклад понад 50 мов за допомогою GitHub Actions
- **Технології**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (для AI-проектів) - **Технології**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (для AI-проектів)
### Архітектура ### Архітектура
- Навчальний репозиторій зі структурою на основі уроків - Навчальний репозиторій зі структурою на основі уроків
- У кожній папці уроку є README, приклади коду та рішення - Кожна папка з уроком містить README, приклади коду та розв’язки
- Автономні проекти в окремих каталогах (quiz-app, різні проекти уроків) - Окремі автономні проекти у власних директоріях (quiz-app, різні проекти уроків)
- Система перекладів з використанням GitHub Actions (co-op-translator) - Система перекладів з використанням GitHub Actions (co-op-translator)
- Документація подається через Docsify та доступна у форматі PDF - Документація подається через Docsify та доступна в PDF
## Команди налаштування ## Команди для налаштування
Цей репозиторій призначений переважно для споживання освітнього контенту. Для роботи з окремими проектами: Цей репозиторій призначений передусім для споживання навчального контенту. Для роботи з конкретними проектами:
### Основне налаштування репозиторію ### Основне налаштування репозиторію
@ -30,18 +30,18 @@
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners cd Web-Dev-For-Beginners
``` ```
### Налаштування Quiz App (Vue 3 + Vite) ### Налаштування додатку Quiz (Vue 3 + Vite)
```bash ```bash
cd quiz-app cd quiz-app
npm install npm install
npm run dev # Запустити сервер розробки npm run dev # Запустити сервер розробки
npm run build # Зібрати для продакшена npm run build # Зібрати для продакшн
npm run lint # Запустити ESLint npm run lint # Запустити ESLint
``` ```
### API банківського проекту (Node.js + Express) ### API банківського проєкту (Node.js + Express)
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
@ -50,23 +50,23 @@ npm start # Запустити API сервер
npm run lint # Запустити ESLint npm run lint # Запустити ESLint
npm run format # Відформатувати за допомогою Prettier npm run format # Відформатувати за допомогою Prettier
``` ```
### Проекти розширень браузера ### Проекти розширень для браузера
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
npm install npm install
# Дотримуйтесь інструкцій з завантаження розширень, специфічних для браузера # Дотримуйтесь інструкцій із завантаження розширень, специфічних для браузера
``` ```
### Проекти гри у космосі ### Проекти космічної гри
```bash ```bash
cd 6-space-game/solution cd 6-space-game/solution
npm install npm install
# Відкрийте index.html у браузері або використовуйте Live Server # Відкрийте index.html у браузері або використайте Live Server
``` ```
### Чат-проект (бекенд на Python) ### Чат-проект (бекенд на Python)
```bash ```bash
@ -75,34 +75,34 @@ pip install openai
# Встановіть змінну середовища GITHUB_TOKEN # Встановіть змінну середовища GITHUB_TOKEN
python api.py python api.py
``` ```
## Робочий процес розробки ## Робочий процес розробки
### Для контрибуторів контенту ### Для учасників контенту
1. **Форкніть репозиторій** у свій обліковий запис GitHub 1. **Форкніть репозиторій** у ваш обліковий запис GitHub
2. **Клонуйте ваш форк** локально 2. **Клонуйте свій форк** локально
3. **Створіть нову гілку** для ваших змін 3. **Створіть нову гілку** для ваших змін
4. Вносьте зміни в контент уроків або приклади коду 4. Вносіть зміни в контент уроків або приклади коду
5. Тестуйте зміни коду у відповідних директоріях проектів 5. Тестуйте зміни коду у відповідних директоріях проектів
6. Надсилайте pull request відповідно до інструкцій з внесення 6. Надсилайте pull request відповідно до правил внеску
### Для учнів ### Для учнів
1. Форкніть або клонують репозиторій 1. Форкніть або клонуюйте репозиторій
2. Перейдіть у каталоги уроків послідовно 2. Перейдіть до директорій уроків послідовно
3. Читайте README файли кожного уроку 3. Читайте README файли кожного уроку
4. Пройдіть початкові вікторини на https://ff-quizzes.netlify.app/web/ 4. Виконуйте тести перед уроком на https://ff-quizzes.netlify.app/web/
5. Опрацьовуйте приклади коду в папках уроків 5. Працюйте з прикладами коду у папках уроку
6. Виконуйте завдання і виклики 6. Виконуйте завдання та виклики
7. Пройдіть фінальні вікторини 7. Пройдіть тести після уроку
### Жива розробка ### Жива розробка
- **Документація**: Запустіть `docsify serve` у корені (порт 3000) - **Документація**: Запустіть `docsify serve` в корені репозиторію (порт 3000)
- **Quiz App**: Запустіть `npm run dev` у директорії quiz-app - **Quiz App**: Запуск `npm run dev` в директорії quiz-app
- **Проекти**: Використовуйте розширення VS Code Live Server для HTML-проектів - **Проекти**: Використовуйте розширення VS Code Live Server для HTML-проектів
- **API-проекти**: Запускайте `npm start` у відповідних API папках - **API проекти**: Запуск `npm start` у відповідних API-директоріях
## Інструкції з тестування ## Інструкції з тестування
@ -113,170 +113,170 @@ cd quiz-app
npm run lint # Перевірте на наявність проблем зі стилем коду npm run lint # Перевірте на наявність проблем зі стилем коду
npm run build # Переконайтеся, що збірка успішна npm run build # Переконайтеся, що збірка успішна
``` ```
### Тестування Bank API ### Тестування Bank API
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm run lint # Перевірте наявність проблем зі стилем коду npm run lint # Перевірте на наявність проблем зі стилем коду
node server.js # Переконайтеся, що сервер запускається без помилок node server.js # Переконайтеся, що сервер запускається без помилок
``` ```
### Загальний підхід до тестування ### Загальний підхід до тестування
- Це навчальний репозиторій без комплексних автоматизованих тестів - Це навчальний репозиторій без повного набору автоматизованих тестів
- Ручне тестування зосереджено на: - Ручне тестування зосереджене на:
- Коректному виконанні прикладів коду без помилок - Виконання коду без помилок
- Роботі посилань у документації - Коректність посилань у документації
- Успішних збірках проектів - Успішне завершення збірок проектів
- Дотриманні найкращих практик у прикладах - Використання кращих практик у прикладах
### Перевірки перед відправкою ### Перевірки перед поданням
- Запускайте `npm run lint` у директоріях з package.json - Запустіть `npm run lint` у директоріях з package.json
- Переконуйтесь, що посилання у markdown дійсні - Переконайтеся, що всі markdown-посилання валідні
- Тестуйте приклади коду у браузері або Node.js - Перевірте приклади коду в браузері або Node.js
- Перевіряйте, що переклади зберігають правильну структуру - Переконайтеся, що переклади збережено правильною структурою
## Керівництво зі стилю коду ## Керівництво зі стилю коду
### JavaScript ### JavaScript
- Використовуйте сучасний синтаксис ES6+ - Використовуйте сучасний синтаксис ES6+
- Дотримуйтесь стандартних конфігурацій ESLint у проектах - Дотримуйтеся стандартних конфігурацій ESLint у проектах
- Використовуйте осмислені імена змінних і функцій для кращого навчання - Використовуйте зрозумілі назви змінних і функцій для навчальної ясності
- Додавайте коментарі, що пояснюють концепції для учнів - Додавайте коментарі із поясненнями концепцій для учнів
- Форматуйте код з Prettier там, де це настроєно - Форматуйте код за допомогою Prettier, якщо налаштовано
### HTML/CSS ### HTML/CSS
- Семантичні елементи HTML5 - Семантичні елементи HTML5
- Принципи адаптивного дизайну - Принципи адаптивного дизайну
- Чіткі конвенції іменування класів - Чіткі конвенції іменування класів
- Коментарі, що пояснюють CSS-техніки для учнів - Коментарі з поясненнями CSS для учнів
### Python ### Python
- Дотримуйтесь стилю PEP 8 - Дотримання стилю PEP 8
- Чіткі навчальні приклади коду - Зрозумілі, освітні приклади коду
- Використовуйте типізацію, коли це корисно для навчання - Типові підказки там, де це допомагає для вивчення
### Документація Markdown ### Документація у Markdown
- Чітка ієрархія заголовків - Чітка ієрархія заголовків
- Блоки коду з вказаною мовою - Блоки коду з вказанням мови
- Посилання на додаткові ресурси - Посилання на додаткові ресурси
- Знімки екрану та зображення у папках `images/` - Скриншоти та зображення у папках `images/`
- Опис для зображень для доступності - Атрибути alt для зображень для доступності
### Організація файлів ### Організація файлів
- Уроки нумеруються послідовно (1-getting-started-lessons, 2-js-basics тощо) - Уроки нумеруются послідовно (1-getting-started-lessons, 2-js-basics тощо)
- Кожен проект має папки `solution/` і часто `start/` або `your-work/` - Кожен проект має каталоги `solution/` та зазвичай `start/` або `your-work/`
- Зображення зберігаються в окремих папках `images/` для кожного уроку - Зображення зберігаються у специфічних для уроків папках `images/`
- Переклади розташовані в структурах `translations/{language-code}/` - Переклади знаходяться у структурах `translations/{language-code}/`
## Збірка і розгортання ## Збірка та розгортання
### Розгортання Quiz App (Azure Static Web Apps) ### Розгортання Quiz App (Azure Static Web Apps)
quiz-app налаштований для розгортання в Azure Static Web Apps: Quiz-app налаштовано для розгортання в Azure Static Web Apps:
```bash ```bash
cd quiz-app cd quiz-app
npm run build # Створює папку dist/ npm run build # Створює папку dist/
# Розгортає за допомогою робочого процесу GitHub Actions при пуші до main # Розгортає через GitHub Actions workflow при пуші в main
``` ```
Конфігурація Azure Static Web Apps:
- **Розташування додатку**: `/quiz-app`
- **Папка виводу**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Генерація PDF документації Налаштування Azure Static Web Apps:
- **Місцезнаходження додатку**: `/quiz-app`
- **Вихідна папка**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Генерація PDF-документації
```bash ```bash
npm install # Встановити docsify-to-pdf npm install # Встановіть docsify-to-pdf
npm run convert # Згенерувати PDF з документів npm run convert # Згенерувати PDF з docs
``` ```
### Документація Docsify ### Документація Docsify
```bash ```bash
npm install -g docsify-cli # Встановити Docsify глобально npm install -g docsify-cli # Встановіть Docsify глобально
docsify serve # Запустити на localhost:3000 docsify serve # Запустіть на localhost:3000
``` ```
### Збірки для конкретних проектів
Кожна директорія проекту може мати свій процес збірки: ### Збірки проектів
- Vue-проекти: `npm run build` створює production-бандли
- Статичні проекти: немає кроку збірки, файли подаються напряму Кожна директорія проекту може мати власний процес збірки:
- Vue-проекти: `npm run build` для створення продакшн-бандлів
- Статичні проекти: немає кроку збірки, файли подаються напряму
## Керівництво для Pull Request ## Правила Pull Request
### Формат заголовку ### Формат заголовка
Використовуйте чіткі описові заголовки, що вказують сферу змін: Використовуйте чіткі, описові заголовки, що вказують на зону змін:
- `[Quiz-app] Додати нову вікторину для уроку X` - `[Quiz-app] Додати новий тест для уроку X`
- `[Lesson-3] Виправити опечатку в проекті terrarium` - `[Lesson-3] Виправити помилку в проекті терраріум`
- `[Translation] Додати іспанський переклад для уроку 5` - `[Translation] Додати іспанський переклад для уроку 5`
- `[Docs] Оновити інструкції з налаштування` - `[Docs] Оновити інструкції з налаштування`
### Обов’язкові перевірки ### Вимоги до перевірок
Перед подачею PR: Перед поданням PR:
1. **Якість коду**: 1. **Якість коду**:
- Запустіть `npm run lint` у відповідних каталогах - Запустіть `npm run lint` у відповідних директоріях проектів
- Виправте всі помилки та попередження lint - Виправте всі помилки та попередження lint
2. **Перевірка збірки**: 2. **Перевірка збірки**:
- Якщо застосовно, запустіть `npm run build` - Запустіть `npm run build` якщо застосовано
- Переконайтесь, що немає помилок збірки - Переконайтеся, що нема помилок збірки
3. **Перевірка посилань**: 3. **Перевірка посилань**:
- Перевірте всі markdown-посилання - Перевірте всі markdown-посилання
- Переконайтесь, що зображення відображаються правильно - Переконайтеся, що посилання на зображення працюють
4. **Перегляд контенту**: 4. **Перевірка контенту**:
- Перевірте орфографію та граматику - Вичитайте на предмет орфографії та граматики
- Переконайтесь, що приклади коду коректні і зрозумілі - Переконайтеся у правильності та освітності прикладів коду
- Перевірте, що переклади зберігають оригінальний зміст - Перевірте переклади на збереження початкового значення
### Вимоги до внеску ### Вимоги до внеску
- Погодитись з Microsoft CLA (автоматична перевірка при першому PR) - Погодьтеся з Microsoft CLA (автоматична перевірка при першому PR)
- Дотримуватись [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) - Дотримуйтесь [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Детальні інструкції в [CONTRIBUTING.md](./CONTRIBUTING.md) - Детальні інструкції у [CONTRIBUTING.md](./CONTRIBUTING.md)
- Якщо є, вказуйте номери issues у описі PR - Вказуйте номери issue у описі PR при потребі
### Процес рев’ю ### Процес огляду
- PR переглядають мейнтейнер та спільнота - PR переглядають мейнтейнер і спільнота
- Пріоритет — освітня зрозумілість - Освітня ясність ставиться у пріоритет
- Приклади коду повинні відповідати актуальним найкращим практикам - Приклади коду мають відповідати актуальним кращим практикам
- Переклади перевіряють на точність та відповідність культурі - Переклади перевіряються на точність та культурну відповідність
## Система перекладів ## Система перекладів
### Автоматичний переклад ### Автоматичний переклад
- Використовує GitHub Actions із workflow co-op-translator - Використовує GitHub Actions з workflow co-op-translator
- Автоматично перекладає більш ніж на 50 мов - Автоматично перекладає на понад 50 мов
- Джерельні файли у основних директоріях - Файли джерела у основних директоріях
- Перекладені файли у папках `translations/{language-code}/` - Перекладені файли у `translations/{language-code}/`
### Додавання ручних покращень перекладу ### Ручне покращення перекладів
1. Знайдіть файл у `translations/{language-code}/` 1. Знайдіть файл у `translations/{language-code}/`
2. Вносьте покращення, зберігаючи структуру 2. Вносьте покращення, зберігаючи структуру
3. Переконайтесь, що приклади коду залишаються працездатними 3. Переконайтеся, що приклади коду лишаються робочими
4. Перевірте будь-який локалізований контент вікторин 4. Тестуйте будь-який локалізований тестовий контент
### Метадані перекладу ### Метадані перекладу
Перекладені файли містять заголовок із метаданими: Перекладені файли містять заголовок із метаданими:
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -288,121 +288,121 @@ CO_OP_TRANSLATOR_METADATA:
} }
--> -->
``` ```
## Налагодження та усунення неполадок ## Налагодження та усунення неполадок
### Поширені проблеми ### Поширені проблеми
**Quiz app не запускається**: **Quiz app не запускається**:
- Перевірте версію Node.js (рекомендується v14+) - Перевірте версію Node.js (рекомендовано v14+)
- Видаліть `node_modules` і `package-lock.json`, виконайте `npm install` знову - Видаліть `node_modules` і `package-lock.json`, запустіть `npm install` знову
- Перевірте конфлікти портів (за замовчуванням Vite використовує порт 5173) - Перевірте конфлікти портів (стандартний порт Vite — 5173)
**API сервер не запускається**: **API сервер не запускається**:
- Переконайтесь, що версія Node.js відповідає мінімальній (node >=10) - Переконайтеся, що версія Node.js відповідає мінімуму (node >=10)
- Перевірте, чи порт вже не зайнятий - Перевірте, чи порт не зайнятий
- Переконайтесь, що всі залежності встановлені через `npm install` - Переконайтеся, що всі залежності встановлені через `npm install`
**Розширення браузера не завантажується**: **Розширення браузера не завантажується**:
- Переконайтесь, що manifest.json правильно сформатований - Перевірте правильність формату manifest.json
- Перевірте консоль браузера на помилки - Перевірте в консолі браузера на наявність помилок
- Дотримуйтесь інструкцій зі встановлення, специфічних для браузера - Дотримуйтеся інструкцій установки специфічних для браузера
**Проблеми з Python чат-проектом**: **Проблеми з Python чат-проектом**:
- Переконайтесь, що пакет OpenAI встановлений: `pip install openai` - Перевірте, що пакет OpenAI встановлено: `pip install openai`
- Переконайтесь, що змінна середовища GITHUB_TOKEN встановлена - Переконайтеся, що встановлено змінну середовища GITHUB_TOKEN
- Перевірте права доступу GitHub Models - Перевірте права доступу до GitHub Models
**Docsify не подає документацію**: **Docsify не подає документацію**:
- Встановіть docsify-cli глобально: `npm install -g docsify-cli` - Встановіть docsify-cli глобально: `npm install -g docsify-cli`
- Запускайте з кореневого каталогу репозиторію - Запускайте з кореневої директорії репозиторію
- Переконайтесь, що файл `docs/_sidebar.md` існує - Переконайтеся, що існує `docs/_sidebar.md`
### Поради для середовища розробки ### Поради для середовища розробки
- Використовуйте VS Code з розширенням Live Server для HTML проектів - Використовуйте VS Code з розширенням Live Server для HTML проектів
- Встановіть розширення ESLint та Prettier для консистентного форматування - Встановіть ESLint та Prettier для узгодженого форматування
- Використовуйте DevTools браузера для налагодження JavaScript - Використовуйте DevTools браузера для налагодження JavaScript
- Для Vue проектів встановіть розширення Vue DevTools для браузера - Для Vue проектів встановіть розширення Vue DevTools браузера
### Особливості продуктивності ### Міркування щодо продуктивності
- Велика кількість перекладених файлів (50+ мов) робить повні клони великими - Велика кількість перекладених файлів (50+ мов) збільшує розмір клонування
- Використовуйте shallow clone, якщо працюєте лише з контентом: `git clone --depth 1` - Використовуйте швидке клонування, якщо працюєте лише з контентом: `git clone --depth 1`
- Виключайте переклади з пошуку при роботі з англійською версією - Виключайте переклади з пошуку при роботі з англійською версією
- Процеси збірки можуть бути повільними при першому запуску (npm install, збірка Vite) - Процеси збірки можуть бути повільними під час першого запуску (npm install, збірка Vite)
## Питання безпеки ## Міркування безпеки
### Змінні середовища ### Змінні середовища
- API-ключі ніколи не повинні комітитись у репозиторій - Ключі API ніколи не повинні потрапляти у репозиторій
- Використовуйте `.env` файли (вже в `.gitignore`) - Використовуйте `.env` файли (вже в `.gitignore`)
- Документуйте необхідні змінні середовища в README проектів - Документуйте потрібні змінні середовища у README проектів
### Python-проекти ### Python проектів
- Використовуйте віртуальні середовища: `python -m venv venv` - Використовуйте віртуальні середовища: `python -m venv venv`
- Оновлюйте залежності - Оновлюйте залежності
- Токени GitHub повинні мати мінімально необхідні дозволи - GitHub токени повинні мати мінімальні необхідні дозволи
### Доступ GitHub Models ### Доступ до GitHub Models
- Потрібні персональні токени доступу (PAT) для GitHub Models - Для GitHub Models потрібні Personal Access Tokens (PAT)
- Токени зберігайте у змінних середовища - Токени треба зберігати як змінні середовища
- Ніколи не комітьте токени або облікові дані - Ніколи не комітьте токени або облікові дані
## Додаткові нотатки ## Додаткові нотатки
### Цільова аудиторія ### Цільова аудиторія
- Повні початківці у веб-розробці - Повні початківці у веб-розробці
- Студенти та самонавчальні - Студенти та самонавчальні
- Викладачі, що використовують курикулум у класах - Вчителі, які використовують курс у класах
- Контент розроблений з урахуванням доступності та поступового нарощування навичок - Контент створений з урахуванням доступності та поступового розвитку навичок
### Освітня філософія ### Освітня філософія
- Підхід на основі проектів - Навчання через проекти
- Часті перевірки знань (вікторини) - Часті перевірки знань (тести)
- Практичні вправи з кодування - Практичні вправи з кодування
- Приклади з реального життя - Приклади із реального світу
- Акцент на основах перед фреймворками - Фокус на основах до вивчення фреймворків
### Підтримка репозиторію ### Підтримка репозиторію
- Активна спільнота учнів і контрибуторів - Активна спільнота учнів і контрибуторів
- Регулярні оновлення залежностей і контенту - Регулярні оновлення залежностей і контенту
- Моніторинг issues і дискусій мейнтейнерами - Моніторинг проблем та обговорень мейнтейнерами
- Оновлення перекладів автоматизовані через GitHub Actions - Автоматизація оновлень перекладів через GitHub Actions
### Пов’язані ресурси ### Пов’язані ресурси
- [Модулі Microsoft Learn](https://docs.microsoft.com/learn/) - [Microsoft Learn modules](https://docs.microsoft.com/learn/)
- [Ресурси Student Hub](https://docs.microsoft.com/learn/student-hub/) - [Student Hub resources](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) рекомендований для учнів - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) рекомендовано для учнів
- Додаткові курси: Generative AI, Data Science, ML, IoT curricula доступні - Додаткові курси: налаштування для Generative AI, Data Science, ML, IoT
### Робота з окремими проектами ### Робота з конкретними проектами
Для детальних інструкцій звертайтеся до README файлів у: Для детальних інструкцій щодо окремих проектів дивіться README файли у:
- `quiz-app/README.md` - Vue 3 додаток вікторин - `quiz-app/README.md` - додаток для тестування на Vue 3
- `7-bank-project/README.md` - Банківський додаток з автентифікацією - `7-bank-project/README.md` - банківський додаток з автентифікацією
- `5-browser-extension/README.md` - Розробка розширень браузера - `5-browser-extension/README.md` - розробка розширень для браузера
- `6-space-game/README.md` - Розробка гри на Canvas - `6-space-game/README.md` - розробка гри з canvas
- `9-chat-project/README.md` - Проект AI чат-асистента - `9-chat-project/README.md` - проект AI чат-асистента
### Структура монорепозиторію ### Структура монорепозиторію
Хоча це не традиційний монорепозиторій, він містить кілька незалежних проектів: Хоча це не традиційний монорепозиторій, він містить кілька незалежних проектів:
- Кожен урок автономний - Кожен урок є автономним
- Проекти не розділяють залежності - Проекти не ділять залежності
- Працюйте з окремими проектами без впливу на інші - Працюйте над окремими проектами без впливу на інші
- Клонуйте весь репозиторій для повного досвіду курсу - Клонуйте увесь репозиторій для повного курсу
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Відмова від відповідальності**: **Застереження**:
Цей документ було перекладено за допомогою сервісу автоматичного перекладу [Co-op Translator](https://github.com/Azure/co-op-translator). Хоча ми прагнемо до точності, будь ласка, майте на увазі, що автоматичні переклади можуть містити помилки або неточності. Оригінальний документ рідною мовою слід вважати авторитетним джерелом. Для критично важливої інформації рекомендується звертатися до професійного людського перекладу. Ми не несемо відповідальності за будь-які непорозуміння чи неправильні тлумачення, що виникли внаслідок використання цього перекладу. Цей документ було перекладено за допомогою сервісу автоматичного перекладу [Co-op Translator](https://github.com/Azure/co-op-translator). Хоч ми і прагнемо до точності, будь ласка, майте на увазі, що автоматичні переклади можуть містити помилки або неточності. Оригінальний документ рідною мовою повинен вважатися авторитетним джерелом. Для критичної інформації рекомендується звертатися до професійного людського перекладу. Ми не несемо відповідальності за будь-які непорозуміння або неправильні тлумачення, що виникають унаслідок використання цього перекладу.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->
Write Preview
Loading…
Cancel
Save