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

pull/1690/head
localizeflow[bot] 3 weeks ago
parent 9115689a31
commit ad7ab49eff

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T10:13:06+00:00",
"translation_date": "2026-02-06T12:01:18+00:00",
"source_file": "AGENTS.md",
"language_code": "hr"
},

@ -2,27 +2,27 @@
## Pregled projekta
Ovo je repozitorij kurikuluma za poučavanje osnova web razvoja početnicima. Kurikulum je sveobuhvatan tečaj u trajanju od 12 tjedana koji su razvili Microsoft Cloud Advocates, a sadrži 24 praktične lekcije koje pokrivaju JavaScript, CSS i HTML.
Ovo je repozitorij edukativnog kurikuluma za podučavanje osnovama web razvoja početnicima. Kurikulum je sveobuhvatan tečaj u trajanju od 12 tjedana kojeg su razvili Microsoft Cloud Advocates, a sadrži 24 praktične lekcije koje pokrivaju JavaScript, CSS i HTML.
### Ključne komponente
- **Obrazovni sadržaj**: 24 strukturirane lekcije organizirane u module zasnovane na projektima
- **Praktični projekti**: Terrarij, Igra tipkanja, Proširenje preglednika, Igra svemira, Bankarska aplikacija, Uređivač koda i AI Chat pomoćnik
- **Interaktivni kvizovi**: 48 kvizova sa po 3 pitanja svaki (procjene prije i poslije lekcija)
- **Podrška za više jezika**: Automatski prijevodi za više od 50 jezika putem GitHub Actions
- **Edukativni sadržaj**: 24 strukturirane lekcije organizirane u module temeljene na projektima
- **Praktični projekti**: Terrarij, Igra tipkanja, Proširenje za preglednik, Svemirska igra, Bankarska aplikacija, Uređivač koda i AI pomoćnik za chat
- **Interaktivni kvizovi**: 48 kvizova sa po 3 pitanja (procjene prije/nakon lekcija)
- **Podrška za više jezika**: Automatski prijevodi za 50+ jezika putem GitHub Actions
- **Tehnologije**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (za AI projekte)
### Arhitektura
- Obrazovni repozitorij sa strukturom temeljnom na lekcijama
- Edukativni repozitorij sa strukturom zasnovanom na lekcijama
- Svaka mapa lekcije sadrži README, primjere koda i rješenja
- Samostalni projekti u posebnim direktorijima (quiz-app, različiti projekti lekcija)
- Sustav prijevoda pomoću GitHub Actions (co-op-translator)
- Dokumentacija se poslužuje putem Docsify te je dostupna i kao PDF
- Sustav prijevoda koristeći GitHub Actions (co-op-translator)
- Dokumentacija poslužena putem Docsify i dostupna kao PDF
## Komande za postavljanje
Ovaj repozitorij je prvenstveno za konzumaciju obrazovnog sadržaja. Za rad s određenim projektima:
Ovaj repozitorij je prvenstveno za konzumaciju edukativnog sadržaja. Za rad sa specifičnim projektima:
### Postavljanje glavnog repozitorija
@ -31,7 +31,7 @@ git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### Postavljanje Quiz Aplikacije (Vue 3 + Vite)
### Postavljanje Quiz App (Vue 3 + Vite)
```bash
cd quiz-app
@ -41,7 +41,7 @@ npm run build # Izgradi za produkciju
npm run lint # Pokreni ESLint
```
### Bankarski projekt API (Node.js + Express)
### Bankarski API projekt (Node.js + Express)
```bash
cd 7-bank-project/api
@ -51,15 +51,15 @@ npm run lint # Pokreni ESLint
npm run format # Formatiraj s Prettierom
```
### Projekti za Proširenje Pretraživača
### Projekti proširenja za preglednik
```bash
cd 5-browser-extension/solution
npm install
# Slijedite upute za učitavanje ekstenzija specifične za preglednik
# Slijedite upute za učitavanje proširenja specifične za preglednik
```
### Projekti igre svemira
### Projekti svemirske igre
```bash
cd 6-space-game/solution
@ -67,7 +67,7 @@ npm install
# Otvorite index.html u pregledniku ili koristite Live Server
```
### Chat projekt (Python Backend)
### Chat projekt (Python backend)
```bash
cd 9-chat-project/solution/backend/python
@ -76,77 +76,77 @@ pip install openai
python api.py
```
## Radni proces razvoja
## Radni tijek razvoja
### Za suradnike na sadržaju
1. **Forkajte repozitorij** na svoj GitHub račun
2. **Kloneajte vaš fork** lokalno
3. **Kreirajte novu granu** za vaše promjene
4. Radite izmjene u sadržaju lekcija ili primjerima koda
5. Testirajte bilo koje promjene koda u relevantnim direktorijima projekata
6. Pošaljite pull requestove prateći pravila doprinosa
1. **Napravite fork repozitorija** na svoj GitHub račun
2. **Klonirajte fork** lokalno
3. **Kreirajte novu granu** za vaše izmjene
4. Izmijenite sadržaj lekcija ili primjere koda
5. Testirajte promjene koda u relevantnim mapama projekata
6. Pošaljite pull request prateći smjernice za doprinos
### Za učenike
1. Forkajte ili klonirajte repozitorij
2. Krenite redom kroz direktorije lekcija
3. Čitajte README datoteke za svaku lekciju
4. Odgovarajte na kvizove prije lekcija na https://ff-quizzes.netlify.app/web/
5. Radite kroz primjere koda u mapama lekcija
1. Napravite fork ili klonirajte repozitorij
2. Prođite lekcije redom u direktorijima
3. Pročitajte README datoteke za svaku lekciju
4. Riješite pre-lesson kvizove na https://ff-quizzes.netlify.app/web/
5. Prođite kroz primjere koda u mapama lekcija
6. Završite zadatke i izazove
7. Uradite kvizove nakon lekcija
7. Riješite post-lesson kvizove
### Živi razvoj
### Live razvoj
- **Dokumentacija**: Pokrenite `docsify serve` u root folderu (port 3000)
- **Quiz aplikacija**: Pokrenite `npm run dev` u quiz-app direktoriju
- **Dokumentacija**: Pokrenite `docsify serve` u korijenu (port 3000)
- **Quiz App**: Pokrenite `npm run dev` unutar direktorija quiz-app
- **Projekti**: Koristite VS Code Live Server ekstenziju za HTML projekte
- **API projekti**: Pokrenite `npm start` u odgovarajućim API direktorijima
## Upute za testiranje
### Testiranje Quiz aplikacije
### Testiranje Quiz App
```bash
cd quiz-app
npm run lint # Provjerite probleme sa stilom koda
npm run build # Provjerite da je izgradnja uspješna
npm run lint # Provjeri probleme sa stilom koda
npm run build # Provjeri uspjeh kompilacije
```
### Testiranje Bank API-ja
```bash
cd 7-bank-project/api
npm run lint # Provjerite probleme sa stilom koda
node server.js # Provjerite pokreće li se poslužitelj bez grešaka
npm run lint # Provjeri probleme sa stilom koda
node server.js # Provjeri pokretanje servera bez grešaka
```
### Općeniti pristup testiranju
### Opći pristup testiranju
- Ovo je obrazovni repozitorij bez opsežnih automatiziranih testova
- Ručno testiranje fokusira se na:
- Ovo je edukativni repozitorij bez opsežnih automatiziranih testova
- Ručno testiranje se fokusira na:
- Primjere koda koji se izvršavaju bez grešaka
- Linkovi u dokumentaciji rade ispravno
- Projekti se uspješno kompajliraju
- Primjeri slijede najbolje prakse
- Ispravnost linkova u dokumentaciji
- Uspješno dovršenje izgradnje projekata
- Primjeri poštuju najbolje prakse
### Provjere prije slanja
### Provjere prije predaje
- Pokrenite `npm run lint` u direktorijima s package.json
- Provjerite jesu li markdown linkovi valjani
- Testirajte primjere koda u pregledniku ili Node.js-u
- Provjerite jesu li prijevodi pravilno strukturirani
- Provjerite valjanost markdown linkova
- Testirajte primjere koda u pregledniku ili Node.js
- Provjerite da prijevodi održavaju ispravnu strukturu
## Smjernice za stil koda
### JavaScript
- Koristite modernu ES6+ sintaksu
- Slijedite standardne ESLint postavke dostupne u projektima
- Koristite smisleni nazive varijabli i funkcija radi boljeg razumijevanja
- Slijedite standardne ESLint konfiguracije u projektima
- Koristite smislena imena varijabli i funkcija radi edukativne jasnoće
- Dodajte komentare koji objašnjavaju koncepte za učenike
- Formatirajte kod koristeći Prettier gdje je konfigurirano
- Formatirajte pomoću Prettier gdje je konfigurirano
### HTML/CSS
@ -157,35 +157,35 @@ node server.js # Provjerite pokreće li se poslužitelj bez grešaka
### Python
- Pravila stila po PEP 8
- Jasni, obrazovni primjeri koda
- Tipizacije tamo gdje pomažu učenju
- Smjernice stila PEP 8
- Jasni, edukativni primjeri koda
- Tipizacija gdje je korisno za učenje
### Markdown dokumentacija
- Jasna hijerarhija naslova
- Kodni blokovi s označenim jezikom
- Linkovi na dodatne resurse
- Sličice i slike u `images/` direktorijima
- Blokovi koda s definicijom jezika
- Linkovi ka dodatnim izvorima
- Snimke zaslona i slike u direktorijima `images/`
- Alt tekst za slike radi pristupačnosti
### Organizacija datoteka
- Lekcije numerirane po redu (1-getting-started-lessons, 2-js-basics itd.)
- Lekcije numerirane sekvencijalno (1-getting-started-lessons, 2-js-basics, itd.)
- Svaki projekt ima `solution/` i često `start/` ili `your-work/` direktorije
- Slike pohranjene u folderima `images/` specifičnim za lekcije
- Prijevodi u strukturi `translations/{language-code}/`
- Slike pohranjene u lekcijsko-specifičnim `images/` mapama
- Prijevodi u `translations/{language-code}/` strukturi
## Izrada i postavljanje
## Izgradnja i implementacija
### Postavljanje Quiz aplikacije (Azure Static Web Apps)
### Implementacija Quiz App (Azure Static Web Apps)
Quiz aplikacija je konfigurirana za postavljanje na Azure Static Web Apps:
Quiz-app je konfiguriran za Azure Static Web Apps implementaciju:
```bash
cd quiz-app
npm run build # Stvara mapu dist/
# Postavlja preko GitHub Actions tijeka rada prilikom guranja na main
npm run build # Kreira dist/ mapu
# Raspoređuje putem GitHub Actions tijeka rada pri pushu na main
```
Konfiguracija Azure Static Web Apps:
@ -197,29 +197,29 @@ Konfiguracija Azure Static Web Apps:
```bash
npm install # Instalirajte docsify-to-pdf
npm run convert # Generiraj PDF iz dokumenata
npm run convert # Generirajte PDF iz docsa
```
### Docsify dokumentacija
```bash
npm install -g docsify-cli # Instalirajte Docsify globalno
docsify serve # Poslužite na localhost:3000
docsify serve # Pokrenite na localhost:3000
```
### Izrade specifične za projekte
### Izgradnje specifične za projekte
Svaki direktorij projekta može imati vlastiti proces izrade:
- Vue projekti: `npm run build` generira produkcijske pakete
- Statički projekti: bez koraka izrade, servirati datoteke direktno
Svaki projektni direktorij može imati vlastiti proces izgradnje:
- Vue projekti: `npm run build` kreira produkcijske bundle-ove
- Statički projekti: Nema koraka izgradnje, datoteke se poslužuju direktno
## Pravila za pull requestove
## Smjernice za pull requestove
### Format naslova
Koristite jasne, opisne naslove koji označavaju područje promjene:
- `[Quiz-app] Dodaj novi kviz za lekciju X`
- `[Lesson-3] Popravi tipfeler u projektu terrarij`
- `[Lesson-3] Ispravi tipfeler u projektu terrarij`
- `[Translation] Dodaj španjolski prijevod za lekciju 5`
- `[Docs] Ažuriraj upute za postavljanje`
@ -228,55 +228,55 @@ Koristite jasne, opisne naslove koji označavaju područje promjene:
Prije slanja PR-a:
1. **Kvaliteta koda**:
- Pokrenite `npm run lint` u pogođenim direktorijima projekata
- Ispravite sve lint greške i upozorenja
- Pokrenite `npm run lint` u pogođenim projektnim direktorijima
- Ispravite sve linting greške i upozorenja
2. **Provjera izrade**:
2. **Provjera izgradnje**:
- Pokrenite `npm run build` ako je primjenjivo
- Provjerite da nema grešaka pri izradi
- Osigurajte da nema grešaka u izgradnji
3. **Provjera linkova**:
- Testirajte sve markdown linkove
- Provjerite da referencije na slike rade
- Provjerite da referenci slika rade
4. **Pregled sadržaja**:
- Provjerite pravopis i gramatiku
- Osigurajte da su primjeri koda ispravni i obrazovni
- Provjerite da prijevodi zadržavaju originalno značenje
- Lektura pravopisa i gramatike
- Provjerite ispravnost i edukativnost primjera koda
- Provjerite točnost i smisao prijevoda
### Zahtjevi za doprinos
- Prihvatite Microsoft CLA (automatska provjera pri prvom PR-u)
- Prihvatite Microsoft CLA (automatska provjera prilikom prvog PR-a)
- Slijedite [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Pogledajte [CONTRIBUTING.md](./CONTRIBUTING.md) za detaljne smjernice
- U PR opisu navodite brojeve povezanih problema ako ih ima
- Referencirajte brojeve issues u opisu PR-a ako je primjenjivo
### Proces pregleda
- PR-ove pregledavaju održavatelji i zajednica
- Prioritet je obrazovna jasnoća
- Primjeri koda trebaju slijediti aktualne najbolje prakse
- Prijevodi se pregledavaju radi točnosti i prikladnosti
- PR-ovi pregledavaju održavatelji i zajednica
- Prioritet je edukativna jasnoća
- Primjeri koda trebaju slijediti postojeće najbolje prakse
- Prijevodi se pregledavaju radi točnosti i kulturne prikladnosti
## Sustav prijevoda
### Automatski prijevod
### Automatizirani prijevod
- Koristi GitHub Actions s co-op-translator workflowom
- Automatski prevodi na više od 50 jezika
- Automatski prevodi na 50+ jezika
- Izvorne datoteke u glavnim direktorijima
- Prevedene datoteke u `translations/{language-code}/` direktorijima
### Dodavanje ručnih poboljšanja prijevoda
1. Pronađite datoteku u `translations/{language-code}/`
2. Unesite poboljšanja uz očuvanje strukture
3. Pazite da primjeri koda ostanu funkcionalni
1. Lokacijski pronađite datoteku u `translations/{language-code}/`
2. Izvršite poboljšanja dok održavate strukturu
3. Osigurajte funkcionalnost primjera koda
4. Testirajte lokalizirani sadržaj kvizova
### Meta podaci prijevoda
### Metapodaci prijevoda
Prevedene datoteke sadrže zaglavlje meta podataka:
Prevedene datoteke uključuju zaglavlje metapodataka:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -291,90 +291,90 @@ CO_OP_TRANSLATOR_METADATA:
## Otklanjanje pogrešaka i rješavanje problema
### Uobičajeni problemi
### Česti problemi
**Quiz aplikacija ne može startati**:
**Quiz app ne može pokrenuti**:
- Provjerite verziju Node.js (preporučeno v14+)
- Izbrišite `node_modules` i `package-lock.json`, zatim pokrenite `npm install` ponovno
- Provjerite da nema sukoba portova (zadani port: Vite koristi 5173)
- Obrišite `node_modules` i `package-lock.json`, pokrenite `npm install` ponovno
- Provjerite konflikte porta (zadani: Vite koristi port 5173)
**API server ne starta**:
- Provjerite da Node.js zadovoljava minimalnu verziju (node >=10)
- Provjerite je li port zauzet
- Provjerite jesu li sve ovisnosti instalirane putem `npm install`
**API server se ne pokreće**:
- Provjerite je li verzija Node.js minimalno zadovoljena (node >=10)
- Provjerite je li port već zauzet
- Provjerite jesu li sve ovisnosti instalirane s `npm install`
**Proširenje preglednika se ne učitava**:
- Provjerite je li manifest.json pravilno formatiran
- Provjerite konzolu preglednika za greške
**Proširenje za preglednik se ne učitava**:
- Provjerite je li manifest.json ispravno formatiran
- Pogledajte konzolu preglednika za greške
- Slijedite upute za instalaciju prema pregledniku
**Problemi s Python chat projektom**:
- Provjerite da je OpenAI paket instaliran: `pip install openai`
- Provjerite da je varijabla okruženja GITHUB_TOKEN postavljena
- Provjerite pristupe za GitHub modele
- Provjerite je li OpenAI paket instaliran: `pip install openai`
- Provjerite je li GITHUB_TOKEN varijabla okoline postavljena
- Provjerite pristup GitHub Modelima
**Docsify ne servisira dokumente**:
**Docsify ne poslužuje dokumente**:
- Instalirajte docsify-cli globalno: `npm install -g docsify-cli`
- Pokrenite iz root direktorija repozitorija
- Provjerite da `docs/_sidebar.md` postoji
- Pokrenite iz korijena repozitorija
- Provjerite postoji li `docs/_sidebar.md`
### Savjeti za razvojno okruženje
- Koristite VS Code s Live Server ekstenzijom za HTML projekte
- Instalirajte ESLint i Prettier ekstenzije za dosljedno formatiranje
- Koristite DevTools u pregledniku za otklanjanje JavaScript pogrešaka
- Za Vue projekte instalirajte Vue DevTools ekstenziju za preglednik
- Koristite DevTools preglednika za debugging JavaScript-a
- Za Vue projekte, instalirajte Vue DevTools ekstenziju za preglednik
### Razmatranja performansi
### Razmatranja o performansama
- Veliki broj prevedenih datoteka (50+ jezika) znače velike kopije repozitorija
- Koristite plitki clone ako radite samo na sadržaju: `git clone --depth 1`
- Isključite prijevode iz pretraživanja kada radite na engleskom sadržaju
- Procesi izrade mogu biti spori pri prvom pokretanju (npm install, Vite build)
- Veliki broj prevedenih datoteka (50+ jezika) znači da su punoklonovi veliki
- Koristite shallow clone ako radite samo na sadržaju: `git clone --depth 1`
- Isključite prijevode iz pretraga kada radite na engleskom sadržaju
- Procesi izgradnje mogu biti spori pri prvom pokretanju (npm install, Vite build)
## Sigurnosna razmatranja
### Varijable okruženja
### Varijable okoline
- API ključevi ne smiju biti u repozitoriju
- Koristite `.env` datoteke (već ih `.gitignore` ignorira)
- Dokumentirajte potrebne varijable okruženja u README datotekama projekata
- API ključevi nikada ne smiju biti commitani u repozitorij
- Koristite `.env` datoteke (već u `.gitignore`)
- Dokumentirajte potrebne varijable okoline u README datotekama projekata
### Python projekti
- Koristite virtualna okruženja: `python -m venv venv`
- Održavajte ovisnosti ažuriranima
- GitHub tokeni trebaju imati minimalne potrebne ovlasti
- GitHub tokeni trebaju imati minimalne potrebne dozvole
### Pristup GitHub modelima
### Pristup GitHub Modelima
- Potrebni su Personal Access Tokeni (PAT) za GitHub modele
- Tokeni treba pohraniti kao varijable okruženja
- Nikada nemojte committati tokene ili vjerodajnice
- Potrebni su Personal Access Tokens (PAT) za GitHub Models
- Tokeni trebaju biti pohranjeni kao varijable okoline
- Nikada nemojte commitati tokene ili vjerodajnice
## Dodatne bilješke
## Dodatne napomene
### Ciljana publika
### Ciljna publika
- Potpuni početnici u web razvoju
- Učenici i samouki
- Studenti i samostalni učenici
- Nastavnici koji koriste kurikulum u učionicama
- Sadržaj je dizajniran za pristupačnost i postupno stjecanje vještina
- Sadržaj je dizajniran za dostupnost i postupno stjecanje vještina
### Pedagoška filozofija
### Edukativna filozofija
- Pristup učenja kroz projekte
- Pristup učenju baziran na projektima
- Česte provjere znanja (kvizovi)
- Praktične vježbe kodiranja
- Primjeri za stvarne primjene
- Fokus na temelje prije okvira
- Primjeri primjene u stvarnom svijetu
- Fokus na osnove prije okvira
### Održavanje repozitorija
- Aktivna zajednica učenika i suradnika
- Redovita ažuriranja ovisnosti i sadržaja
- Praćenje problema i diskusija od strane održavatelja
- Ažuriranja prijevoda automatizirana preko GitHub Actions
- Praćenje issue-a i diskusija od strane održavatelja
- Automatizirane nadopune prijevoda putem GitHub Actions
### Povezani resursi
@ -383,26 +383,26 @@ CO_OP_TRANSLATOR_METADATA:
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) preporučen za učenike
- Dodatni tečajevi: Generativni AI, Data Science, ML, IoT kurikulumi dostupni
### Rad s određenim projektima
### Rad sa specifičnim projektima
Za detaljne upute za pojedinačne projekte, pogledajte README datoteke u:
- `quiz-app/README.md` - Vue 3 quiz aplikacija
- `7-bank-project/README.md` - Bankarska aplikacija s autentifikacijom
Za detaljne upute o pojedinačnim projektima, pogledajte README datoteke u:
- `quiz-app/README.md` - Vue 3 aplikacija kviz
- `7-bank-project/README.md` - Bankarska aplikacija s autentikacijom
- `5-browser-extension/README.md` - Razvoj proširenja za preglednik
- `6-space-game/README.md` - Razvoj igre zasnovane na Canvasu
- `9-chat-project/README.md` - AI chat pomoćnik projekt
- `6-space-game/README.md` - Razvoj igre na canvasu
- `9-chat-project/README.md` - AI chat pomoćnički projekt
### Struktura monorepa
### Monorepo struktura
Iako nije tradicionalni monorepo, ovaj repozitorij sadrži više nezavisnih projekata:
Iako nije klasični monorepo, ovaj repozitorij sadrži više nezavisnih projekata:
- Svaka lekcija je samostalna
- Projekti ne dijele ovisnosti
- Radite na pojedinačnim projektima bez utjecaja na ostale
- Klonirajte cijeli repozitorij za cjelokupno iskustvo kurikuluma
- Rad na pojedinačnim projektima bez utjecaja na druge
- Klonirajte cijeli repozitorij za potpuni doživljaj kurikuluma
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Odricanje od odgovornosti**:
Ovaj je dokument preveden korištenjem AI prevoditeljske usluge [Co-op Translator](https://github.com/Azure/co-op-translator). Iako težimo točnosti, imajte na umu da automatski prijevodi mogu sadržavati pogreške ili netočnosti. Izvorni dokument na njegovom izvornom jeziku treba se smatrati autoritativnim izvorom. Za kritične informacije preporučuje se profesionalni ljudski prijevod. Ne snosimo odgovornost za bilo kakva nesporazumevanja ili pogrešna tumačenja koja proizlaze iz korištenja ovog prijevoda.
Ovaj dokument je preveden korištenjem AI prevoditeljskog servisa [Co-op Translator](https://github.com/Azure/co-op-translator). Iako nastojimo biti točni, imajte na umu da automatski prijevodi mogu sadržavati pogreške ili netočnosti. Izvorni dokument na njegovom izvornom jeziku treba smatrati autoritativnim izvorom. Za kritične informacije preporučuje se profesionalni ljudski prijevod. Nismo odgovorni za bilo kakve nesporazume ili netočne interpretacije koje proizlaze iz korištenja ovog prijevoda.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T10:15:57+00:00",
"translation_date": "2026-02-06T12:04:02+00:00",
"source_file": "AGENTS.md",
"language_code": "my"
},

@ -2,27 +2,27 @@
## Project Overview
ဤသည်မှာ ဝဘ်ဖွံ့ဖြိုးတိုးတက်ခြင်း အခြေခံများကို စတင်သင်ကြားလိုသူများအတွက် သင်ကြားရေး အကြောင်းအရာစုစည်းထားသော သင်ခန်းစာအုပ်အားဖြစ်သည်။ Microsoft Cloud Advocates မှ ဖန်တီးထားသော १२ ပတ်ကြာ သင်ခန်းစာ လုံးဝကျယ်ဝန်း သည် JavaScript၊ CSS နှင့် HTML ကို စုစည်းခြင်းဖြင့် ၂၄ ခန်းသင်ခန်းစာ ပါရှိသည်။
ဤသည်မှာ web development မျိုးစွဲအခြေခံများကို စတင်သင်ကြားရန်အတွက် ပညာရေး သင်ရိုးညွှန်းတမ်း_repository_ တစ်ခုဖြစ်သည်။ သင်ရိုးညွှန်းတမ်းသည် Microsoft Cloud Advocates မှ ဖန်တီးထားသော ၁၂-ပတ်ကြာ သင်တန်းအစီအစဉ်တစ်ရပ်ဖြစ်ပြီး 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
repository သည် ပညာရေး အကြောင်းအရာများ အသုံးပြုရုံ ရည်ရွယ်ပါသည်။ သီးခြား ပရောဂျက်များ ဖြင့် အလုပ်လုပ်လိုပါက -
ဖိုင်တိုက်သည် အဓိကအားဖြင့် ပညာရေးအကြောင်းအရာ အသုံးပြုမှုအတွက်ဖြစ်သည်။ အသီးသီး ပရောဂျက်များနှင့်အတူ အလုပ်လုပ်လိုပါက -
### Main Repository Setup
@ -36,9 +36,9 @@ cd Web-Dev-For-Beginners
```bash
cd quiz-app
npm install
npm run dev # ဖွံ့ဖြိုးရေးဆာဗာကို စတင်ပါ
npm run build # ထုတ်လွှတ်မှုအတွက် တည်ဆောက်ပါ
npm run lint # ESLint ကို ပြေးပါ
npm run dev # ဖွံ့ဖြိုးတိုးတက်မှု ဆာဗာကို စတင်ပါ
npm run build # ထုတ်လုပ်မှုအတွက် ဆောက်လုပ်ပါ
npm run lint # ESLint ကို အလုပ်လုပ်ရန် ဖြစ်ပါသည်
```
### Bank Project API (Node.js + Express)
@ -46,9 +46,9 @@ npm run lint # ESLint ကို ပြေးပါ
```bash
cd 7-bank-project/api
npm install
npm start # API ဆာဗာကို စတင်ပါ
npm run lint # ESLint ကို ပြေးပါ
npm run format # Prettier နဲ့ ဖော်မတ်လုပ်ပါ
npm start # API စာရင်းကို စတင်ပါ
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
# ဘရောက်ဇာအလိုက်နဲ့ ပရိုဂရမ်ချိတ်ဆက်မှုများ ဖတ်သွင်းရန် ညွှန်ကြားချက်များကို လိုက်နာပါ။
# ဘရိုဇာအလိုက် အထူးသဒီခံ များတင်သွင်းနည်း အညွှန်းများကို လိုက်နာပါ။
```
### 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 အကောင့်တွင် repository ကို fork လုပ်ပါ**
2. **Fork ကို ဒေသငယ်တွင် clone လုပ်ပါ**
3. **မိမိပြင်ဆင်လိုသည့် ပြောင်းလဲမှုများအတွက် ဂျိုးဓာတ် အသစ် ဖန်တီးပါ**
4. သင်ခန်းစာအကြောင်းအရာ သို့မဟုတ် ကိုးဒ် နမူနာများ ပြင်ဆင်ပါ
5. ဆိုင်သော project ဖိုလ်ဒါများတွင် ကဒ် ပြောင်းလဲမှု စမ်းသပ်ပါ
6. အသုံးချနည်းလမ်းညွှန်ချက်များနှင့် အညီ pull request များတင်သွင်းပါ
1. **Repository ကို ဖော့ခ်လုပ်ပါ** သင့် GitHub အကောင့်သို့
2. **ဖော့ခ်လုပ်ထားသောကို ဒေါင်းလုပ်လုပ်ပါ** ဒေသရပ်ဆိုင်သောစက်၌
3. **သွားလိုသည့် ပြောင်းလဲမှုများအတွက် အသစ်သော ဘရောင်းချ်ဖန်တီးပါ**
4. သင်ခန်းစာအကြောင်းအရာ သို့မဟုတ်ကုဒ်ဥပမာများ ပြင်ဆင်ပါ
5. သက်ဆိုင်ရာပရောဂျက် ဖိုလ်ဒါများတွင် ကုဒ်ပြောင်းလဲမှုများ စမ်းသပ်ပါ
6. မိတ်ဆက်ချက်ညွှန်ကြားချက်များအတိုင်း pull request တင်ပြပါ
### For Learners
1. Fork သို့မဟုတ် clone လုပ်ပါ
2. သင်ခန်းစာ ဖိုလ်ဒါများကို အဆက်ဆက် သွားပါ
3. တစ်ခန်းချင်း README ဖိုင်များဖတ်ပါ
4. https://ff-quizzes.netlify.app/web/ တွင် သင်ခန်းစာမတိုင်မီ မေးပွဲများ ဖြေဆိုပါ
5. သင်ခန်းစာ ဖိုလ်ဒါများရှိ ကိုးဒ်နမူနာများ ဖြတ်သန်း လေ့လာပါ
6. တာဝန်နှင့် စိန်ခေါ်မှုများ ပြီးမြောက်စွာ ဖြေရှင်းပါ
7. သင်ခန်းစာပြီးနောက် မေးပွဲများ ဖြေဆိုပါ
1. Repository ကို fork လုပ်ခြင်း သို့မဟုတ် clone လုပ်ခြင်း
2. သင်ခန်းစာ ဖိုလ်ဒါများ အဆက်အစပ်သွားပါ
3. နေရာတိုင်းတွင် README ဖိုင်များ ဖတ်ပါ
4. https://ff-quizzes.netlify.app/web/ တွင် သင်ခန်းစာမတိုင်မီ စစ်ဆေးမှု မေးခွန်းများ ဖြေဆိုပါ
5. သင်ခန်းစာဖိုလ်ဒါများရှိ ကုဒ်ဥပမာများခေါက်ထဲတွင် လေ့လာပါ
6. တာဝန်ယူချက်များနှင့် စိန်ကြိုးမှုများ ပြီးမြောက်ပါ
7. သင်ခန်းစာပြီးနောက် မေးခွန်းများ ဖြေဆိုပါ
### Live Development
- **စာရွက်စာတမ်းများ**: root တွင် `docsify serve` အသုံးပြု၍ လုပ်ဆောင်ပါ (port 3000)
- **Quiz App**: quiz-app ဖိုလ်ဒါတွင် `npm run dev` အလုပ်အမှန်ပြုပါ
- **Projects**: HTML ပရောဂျက်များအတွက် VS Code Live Server extension ကို သုံးပါ
- **API Projects**: API သက်ဆိုင်ရာ ဖိုလ်ဒါများ၌ `npm start` ကို လည်ပတ်ပါ
- **မှတ်တမ်းကျော်**: အဓိကဖိုင်တွင် `docsify serve` ကို ဖွင့်ပါ (port 3000)
- **Quiz App**: quiz-app ဖိုလ်ဒါတွင် `npm run dev` ကို ဖွင့်ပါ
- **Projects**: HTML ပရောဂျက်များအတွက် VS Code Live Server extension ကို သုံးပြုပါ
- **API Projects**: သက်ဆိုင်ရာ API ဖိုလ်ဒါများတွင် `npm start` ကို သုံးပါ
## Testing Instructions
@ -110,85 +110,85 @@ 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 # Error မရှိဘဲ ဆာဗာ စတင်လုပ်ဆောင်နိုင်မှုကို သေချာစွာ စစ်ဆေးပါ
npm run lint # ကုဒ်ပုံစံပြဿနာများကို စစ်ဆေးပါ
node server.js # ဆာဗာသည် အမှားမပါဘဲ စတင်အောင် သေချာစစ်ဆေးပါ
```
### General Testing Approach
- အပြည့်စုံသော အလိုအလျောက် စမ်းသပ်မှု မပါဝင်သော ပညာရေး repository ဖြစ်သည်
- လက်တွေ့စမ်းသပ်မှုမှာ အဓိကအားဖြင့်
- ကိုးဒ်နမူနာများ အမှားမပေါ် အလုပ်လုပ်မှု
- စာရွက်စာတမ်းများအတွင်း လင့်များမှန်ကန်မှု
- ပရောဂျက် တည်ဆောက်မှု အောင်မြင်မှု
- နမူနာများသည် သင်ကြားရေးအတွက် လိုက်နာမှု ရှိခြင်း
- ဤသည်မှာ အထူးသဖြင့် စနစ်တကျ အလိုအလျှောက် စမ်းသပ်မှု မပါသော ပညာရေးဖိုင်တိုက်ဖြစ်သည်
- လက်တွေ့ စမ်းသပ်မှုများ တွင် အောက်ပါအချက်များအပေါ် ဂရုပြုရမည်။
- ကုဒ်ဥပမာများ အမှားမရှိစွာ လုပ်ဆောင်နိုင်ခြင်း
- မှတ်တမ်းတွင် လင့်များလုံးဝ အလုပ်လုပ်နိုင်ခြင်း
- ပရောဂျက်များ ကို ထုတ်လုပ်မှု အောင်မြင်စွာ ပြီးဆုံးခြင်း
- ဥပမာများသည် စံချိန်စံညွှန်းနည်းလမ်းများအတိုင်းရှိခြင်း
### Pre-submission Checks
- package.json ပါသော ဖိုလ်ဒါများတွင် `npm run lint` ပြီးစစ်ဆေးပါ
- Markdown links များမှန်ကန်စိစစ်ပါ
- ကိုးဒ်နမူနာများကို browser သို့မဟုတ် Node.js တွင် စမ်းသပ်ပါ
- ဘာသာပြန်မှုများသည် ဖွဲ့စည်းပုံကို ထိန်းသိမ်းခြင်းရှိပုံစစ်ဆေးပါ
- package.json ပါသော ဖိုလ်ဒါများတွင် `npm run lint` ဖြင့် စစ်ဆေးပါ
- markdown links များမှန်ကန်ကြောင်းစစ်ဆေးပါ
- ကုဒ်ဥပမာများကို browser သို့ Node.js တွင် စမ်းသပ်ပါ
- ဘာသာပြန်မှုများသည် စနစ်တကျရှိရေးကို စစ်ဆေးပါ
## Code Style Guidelines
### JavaScript
- ခေတ်မီသော ES6+ စာလုံးကွက်များ အသုံးပြုပါ
- ပရောဂျက်များတွင် ပံ့ပိုးထားသည့် standard ESLint စည်းမျဉ်းများ လိုက်နာပါ
- ပညာရေး ရည်ရွယ်ချက်အတွက် အဓိပ္ပါယ်ရှိသည့် variable နှင့် function အမည်များအသုံးပြုပါ
- သင်ကြားသူ ထိန်းညွှန်ရန် မှတ်ချက်များ ထည့်သွင်းပါ
- Prettier ဖြင့် စာလုံးပုံစံ ဖော်ပြမှု
- အဆင့်မြင့် ES6+ စနစ်ကို အသုံးပြုပါ
- ပရောဂျက်များတွင် ထည့်သွင်းထားသည့် ကြိုးပမ်းမှု standard ESLint configurations တွေလိုက်နာပါ
- ပညာရေးအတွက် မှတ်သားပိုမိုချင်စိတ်ကို အဓိကထားသည့် အဓိပ္ပာယ်ကောင်းသော အမည်များသုံးပါ
- သင်ယူသူများအတွက်ပါ အကြောင်းအရာရှင်းပြချက် မက်ဆေ့ခ််များထည့်ပါ
- ရေးသားတပ်ဆင်ထားသော Prettier ဖြင့် ဖောမတ်လုပ်ခြင်း
### HTML/CSS
- Semantic HTML5 အစိတ်အပိုင်းများ အသုံးပြုပါ
- တုံ့ပြန်နိုင်သော ဖော်မြူလာ အခြေခံချက်များ
- အတန်းအမည် သေချာ ကောင်းမွန်စွာ သတ်မှတ်ခြင်း
- CSS နည်းပညာများ သင်ကြားရေးအတွက် မှတ်ချက်ထည့်ရန်
- အဓိက အဓိပ္ပာယ်မြင့် HTML5 elements သုံးပါ
- တုံ့ပြန်မှုရှိသော ဒီဇိုင်နည်းများ
- သတ်မှတ်ထားသည့် class နာမည်ခေါင်းစဉ်များ ရှင်းလင်းစွာ သတ်မှတ်ခြင်း
- သင်ယူသူများအတွက် CSS နည်းလမ်းများ မှတ်ချက်ဖြင့် ရှင်းပြချက်ဖြည့်စွက်ခြင်း
### Python
- PEP 8 စတိုင် လမ်းညွှန်ချက်များ
- သန့်ရှင်းလတ်ဆတ်သော ပညာရေးရည်ရွယ် တည်ဆောက်ထားသည့် နမူနာများ
- လေ့လာသူများအတွက် အကူအညီဖြစ်စေရန် type hints ထည့်သွင်းခြင်း
- PEP 8 စတိုင်လမ်းညွှန်ချက်များ
- ရှင်းလင်းသောပညာရေးကုဒ်ဥပမာများ
- သင်ယူထောက်ပံ့မှုအတွက် type hints ထည့်ရန်
### Markdown Documentation
- ခေါင်းစဉ် အဆင့်များ ထိရောက်သော စီမံချက်
- ဘာသာရေးဖော်ပြချက်ပါသော ကိုးဒ်ကွက်များ
- နောက်ထပ် အရင်းအမြစ်များသို့ လင့်ခ်များ
- `images/` ဖိုလ်ဒါများတွင် ဓာတ်ပုံများ နှင့် ပုံများ
- မျက်မှောက်စာသားများ တွင် သေချာသော alt စာသားများ၊ နှင့် ထောက်ပံ့မှု
- ဦးခေါင်းများ ပေါ်ပုံ ရှင်းလင်းစွာထားရှိခြင်း
- ဘာသာစကားသတ်မှတ်ချက်ပါသည့် ကုဒ်ဘလော့များ
- ထပ်ဆောင်းရင်းမြစ်များဆီ လင့်ခ်များ
- `images/` ဖိုလ်ဒါများရှိ နမူနာပုံများနှင့် စာရွက်ပုံများ
- အသုံးပြုနိုင်ရေးအတွက် ပုံများ၏ alt စာသားများ
### File Organization
- သင်ခန်းစာအမှတ်စဉ်ဖြင့် အမွှာများ (ဥပမာ- 1-getting-started-lessons, 2-js-basics, စသည်)
- တစ်ခုချင်း project တွင် `solution/` နှင့် မကြာခဏ `start/` သို့မဟုတ် `your-work/` ဖိုလ်ဒါများ ပါဝင်သည်
- သင်ခန်းစာအသီးသီး၏ `images/` ဖိုလ်ဒါများတွင် ဓာတ်ပုံများ သိမ်းဆည်းထားသည်
- ဘာသာပြန်မှုများကို `translations/{language-code}/` ဖိုလ်ဒါတွင် သိမ်းဆည်းထားသည်
- သင်ခန်းစာများ အဆက်ဆက်အမှတ်စဉ်(၁-getting-started-lessons, ၂-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 ဖြင့် ဖြန့်ချိသည်
# main branch သို့ push လုပ်သောအခါ GitHub Actions workflow ဖြင့် တင်သွင်းသည်
```
Azure Static Web Apps ပြင်ဆင်မှု-
Azure Static Web Apps configuration:
- **App location**: `/quiz-app`
- **Output location**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
@ -196,28 +196,28 @@ Azure Static Web Apps ပြင်ဆင်မှု-
### 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 တွင် ၀န်ဆောင်မှုတင်ရန်
npm install -g docsify-cli # Docsify ကို ကမ္ဘာလုံးဆိုင်ရာ ထည့်သွင်းပါ
docsify serve # localhost:3000 ပေါ်တွင် ဆာဗ်ဖြစ်ပါစေ
```
### Project-specific Builds
ပရောဂျက် တစ်ခုချင်းစီတွင် မတူညီသည့် build လုပ်ငန်းစဉ်ရှိနိုင်ပါသည်-
- Vue projects: `npm run build` ဖြင့် ထုတ်လုပ်မှု bundle များ ဖန်တီးခြင်း
- Static projects: Build အဆင့် မရှိပါ, ဖိုင်များကိုတိုက်ရိုက် တင်ဆက်သည်
ပရောဂျက်တိုင်းသည် ကိုယ်ပိုင် ထုတ်လုပ်မှုလုပ်ငန်းစဉ်များရှိနိုင်သည် -
- Vue ပရောဂျက်များတွင် `npm run build` ဖြင့် ထုတ်လုပ်မှု bundle များပြုလုပ်သည်
- static ပရောဂျက်များတွင် build လုပ်မှု မရှိ၊ ဖိုင်များကို တိုက်ရိုက် ဝန်ဆောင်မှု ပေးသည်
## Pull Request Guidelines
### Title Format
ပြောင်းလဲမှု နယ်ပယ်ကို ရှင်းလင်းဖော်ပြထားသည့် ခေါင်းစဉ်များ အသုံးပြုပါ-
ပြောင်းလဲမှု အစိတ်အပိုင်းကို ထည့်သွင်းညွှန်းသော ကိုကျောက်ဆိုး စာရေးပါ -
- `[Quiz-app] Add new quiz for lesson X`
- `[Lesson-3] Fix typo in terrarium project`
- `[Translation] Add Spanish translation for lesson 5`
@ -225,58 +225,57 @@ docsify serve # localhost:3000 တွင် ၀န်ဆော
### Required Checks
PR တင်သွင်းမှီ
PR တင်သည့်အခါမှာ -
1. **Code Quality**:
- ပရောဂျက် ဒိုင်ရက်ထရီများတွင် `npm run lint` ပြုလုပ်ပါ
- လင့်န့် အမှားများ နှင့် သိပေးချက်များအားလုံး ပြင်ဆင်ပါ
1. **ကုဒ်အရည်အသွေး**:
- သက်ဆိုင်ရာ project ဖိုလ်ဒါများတွင် `npm run lint` ပြေးပါ
- အမှားနှင့် သိပေးချက်များအားလုံး ပြင်ဆင်ပါ
2. **Build Verification**:
- အသုံးပြုမည့် ပရောဂျက်တွင် `npm run build` လုပ်ပါ
- Build အမှား မရှိဖြစ်စေရန် စစ်ဆေးပါ
2. **ထုတ်လုပ်မှု ပြုလုပ်ခြင်း စစ်ဆေးမှု**:
- လိုက်လျောညီထွေရှိပါက `npm run build` ပြုလုပ်ပါ
- ရှာဖွေတွေ့ရှိသော အမှားမရှိကြောင်း သေချာစေပါ
3. **Link Validation**:
- Markdown link များအားလုံး စစ်ဆေးပါ
- ဓာတ်ပုံ ဆက်သွယ်မှုများ အလုပ်လုပ်မှု စစ်ဆေးပါ
3. **လင့်ခ် စစ်တမ်း**:
- markdown သို့မဟုတ် ပုံဆိုင်ရာ လင့်ခ်များအားလုံး စစ်ဆေးပါ
4. **Content Review**:
- ရေးသားချက်များ စစ်ဆေးပါ (စာလုံးပေါင်း၊ သရုပ်ခွဲမှု)
- ကိုးဒ်နမူနာများ မှန်ကန်ပြီး သင်ကြားမှုအတွက် သင့်တော်စေရန် စစ်ဆေးပါ
- ဘာသာပြန် အကြောင်းအရာ မူရင်း၏ အဓိပ္ပါယ် ထိန်းသိမ်းမှုရှိရန် စစ်ဆေးပါ
4. **အကြောင်းအရာ ပြန်လည်သုံးသပ်ခြင်း**:
- စာလုံးပေါင်းနှင့် စာကြောင်းမှားပေါ် မရှိစေပါနှင့်
- ကုဒ်ဥပမာများမှန်ကန်ပြီး ပညာရေးအတွက် ရည်ရွယ်ထားသည်မှန်ကန်စေရန်
- ဘာသာပြန်မှုများသည် မူရင်းအဓိပ္ပာယ်လိုက်ဖက်မှုရှိရေးကို စစ်ဆေးပါ
### Contribution Requirements
- Microsoft CLA ကို လက်မှတ်ရေးထိုးရန် သဘောတူပါ (ပထမ PR တွင် စက်မှုစွဲချက်)
- Microsoft CLA အတည်ပြုပါ (ပထမဆုံး PR မှာ အလိုအလျှောက် စစ်ဆေးမှု)
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) ကိုလိုက်နာပါ
- အသေးစိတ်လမ်းညွှန်ချက်များအတွက် [CONTRIBUTING.md](./CONTRIBUTING.md) ကိုကြည့်ပါ
- PR မှာ ပြဿနာနံပါတ်များ ပါရှိပါက ဖော်ပြပါ
- အသေးစိတ် ညွှန်ကြားချက်များအတွက် [CONTRIBUTING.md](./CONTRIBUTING.md) ကိုကြည့်ပါ
- PR ရှင်းလင်းချက်တွင် issue နံပါတ်များ ထည့်သွင်းပါ
### Review Process
- PR များကို စောင့်ကြည့်သူများနှင့် လူထုက တွေ့ဆုံသုံးသပ်ပါသည်
- ပညာရေးအတွက် သက်ဆိုင်သည့် ပြတ်သားမှုကို ဦးစားပေးပါသည်
- ကိုးဒ်နမူနာများသည် ယနေ့အချိန်အကောင်းဆုံး လမ်းစဉ်များနှင့်ကိုက်ညီရန
- ဘာသာပြန်မှုများကို ထိရောက်မှုနှင့် ယဉ်ကျေးမှု သင့်တော်မှု ရှိရှိသုံးသပ်ပါသည်
- PR များသည် ပြုပြင်သူများနှင့် လူထုကနေ သုံးသပ်သည်
- ပညာရေး ရည်ရွယ်ချက်များကို အထူး ဦးလေးပေးသည်
- ကုဒ်ဥပမာများသည် လက်ရှိ စံနှုန်းများနှင့် ကိုက်ညီရန် လိုအပ်သည
- ဘာသာပြန်မှုများကို တိကျမှန်ကန်မှုနှင့် ယဉ်ကျေးမှုလိုက်ဖက်မှုအခြေအနေဖြင့် သုံးသပ်သည်
## Translation System
### Automated Translation
- GitHub Actions တွင် co-op-translator workflow ကို အသုံးပြုသည်
- ၅၀ ကျော် ဘာသာစကားများသို့ အလိုအလျောက် ဘာသာပြန်သည်
- မူလ ဖိုင်များ ခုခံထားသော ဒိုင်ရက်ထရီများ၌ရှိသည်
- ဘာသာပြန်ထားသော ဖိုင်များ `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 header ပါဝင်သည် -
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -293,116 +292,116 @@ CO_OP_TRANSLATOR_METADATA:
### Common Issues
**Quiz app စတင်မရခြင်း**:
- Node.js ဗားရှင်း (v14+) ဖြစ်ဟု စစ်ဆေးပါ
- `node_modules` နှင့် `package-lock.json` ဖိုင်များ ဖျက်ပြီး `npm install` ထပ်လုပ်ပါ
- port မှုကိုစစ်ဆေးပါ (ပုံမှန်အားဖြင့် Vite သည် port 5173 ကိုသုံးသည်)
**Quiz app မဖြင့်တော့ခြင်း**:
- Node.js ဗားရှင်းစစ်ဆေးပါ (v14+ ကိုအကြံပြု)
- `node_modules` နှင့် `package-lock.json` ဖိုင်များ ဖျက်ပြီး `npm install` ထပ်တွဲဆောင်ရွက်ပါ
- ပေါ့(Port) ပဋိပက္ခ မရှိကြောင်း စစ်ဆေးပါ (Vite သည် ပုံမှန် 5173 ပေါ့သုံးသည်)
**API server မစတင်နိုင်ခြင်း**:
- Node.js ဗားရှင်း (node >=10) ဖြည့်စွက်စစ်ဆေးပါ
- port သုံးနေခြင်းရှိမရှိ စစ်ဆေးပါ
- စနစ်တကျ `npm install` ဖြင့် dependency များ ထည့်သွင်းခြင်းရှိမှန်း စစ်ဆေးပါ
**API server မဖွင့်ခြင်း**:
- Node.js ဗားရှင်းဖြည့်စွက် ရှိပါစေ (node >=10)
- ပေါ့ (port)ကို အသုံးပြုနေမှု မရှိကြောင်း သေချာစေရန် စစ်ဆေးပါ
- လိုအပ်သည့် dependency များအားလုံး `npm install` ဖြင့် ထည့်သွင်းပြီးကြောင်း သေချာကာ
**Browser extension မတင်နိုင်ခြင်း**:
- manifest.json ဖိုင်ကို မှန်ကန်စွာ ဖော်ပြထားမှုကို စစ်ဆေးပါ
- browser console တွင် အမှားပေါ်ရှိမရှိကြည့်ပါ
- browser အလိုက် extension install လမ်းညွှန်ချက်အတိုင်း လုပ်ဆောင်ပါ
- manifest.json format မှန်ကန်မှု
- browser console မှာ အမှားမရှိကြောင်း စစ်ဆေးပါ
- browser-specific extension တပ်ဆင်မှုအညွှန်းများ လိုက်နာပါ
**Python chat project ပြဿနာများ**:
- OpenAI package ထည့်သွင်းရန်: `pip install openai`
- GITHUB_TOKEN ဘက်Env variable မှတ်ထားပါ
- GitHub Models သို့ ဝင်ရောက်ခွင့် သေချာစစ်ဆေးပါ
**Python chat project ပြဿနာ**:
- OpenAI package တပ်ဆင်ထားမှု `pip install openai`
- GITHUB_TOKEN environment variable သတ်မှတ်ထားမှု
- GitHub Models အတွက် လက်မှတ်ခွင့်များရှိမှုစစ်ဆေးပါ
**Docsify စာရွက်စာတမ်း မပေးဆောင်ခြင်း**:
- docsify-cli ကို global install လုပ်ပါ: `npm install -g docsify-cli`
- repository root ထဲမှ run နိုင်ရန် စစ်ဆေးပါ
- `docs/_sidebar.md` ရှိမရှိစစ်ဆေးပါ
**Docsify မှတ်တမ်းမဖွင့်ခြင်း**:
- `docsify-cli` ကို ပိုင်းလောဂျီအားဖြင့် တပ်ဆင်ပါ - `npm install -g docsify-cli`
- Repository အမြစ် ဒါရိုက်တာထိုင်မှ ပေါ်တင်ပါ
- `docs/_sidebar.md` ရှိကြောင်းစစ်ဆေးပါ
### Development Environment Tips
- HTML ပရောဂျက်များအတွက် VS Code Live Server extension အသုံးပြုပါ
- ESLint နှင့် Prettier extension များ ထည့်သွင်းပါ
- JavaScript debug အတွက် browser DevTools အသုံးပြုပါ
- Vue ပရောဂျက်များအတွက် Vue DevTools browser extension ထည့်သွင်းပါ
- ESLint နှင့် Prettier extension များတပ်ဆင်ပြီး ဖောင်မက်ကို စနစ်တကျ ထိန်းသိမ်းပါ
- JavaScript debugging အတွက် browser DevTools အသုံးပြုပါ
- Vue ပရောဂျက်များအတွက် Vue DevTools browser extension တပ်ဆင်ပါ
### Performance Considerations
- ဘာသာပြန်ဖိုင် အများကြီး (၅၀+ ဘာသာ) ရှိသောကြောင့် ဖိုင် clone ထားခြင်း ကြီးမားနိုင်သည်
- အကြောင်းအရာမှသာ လုပ်ရင် shallow clone ကို အသုံးပြုနိုင်သည်: `git clone --depth 1`
- အင်္ဂလိပ်အကြောင်းအရာ ဆက်လက် အလုပ်လုပ်မည့်အခါ ဘာသာပြန်စာရွက်များကို ရှာဖွေမှုမှ ရှောင်ရှားပါ
- Build ဆောင်ရွက်မှုများသည် ပထမဆုံး run အချိန်တွင် နှေးကွေးနိုင်သည် (npm install, Vite build)
- ဘာသာပြန်ဖိုင်များ (၅၀+ ဘာသာစကား) အရေတွက်ကြီးကြောင်းကြောင့် clone အကြီးအကျယ် ဖြစ်နိုင်သည်
- content သာ အလုပ်လုပ်မည်ဆိုပါက shallow clone အသုံးပြုပါ - `git clone --depth 1`
- အင်္ဂလိပ်ဘာသာများတွင် ဘာသာပြန်မှုများကို ရှာဖွေမှုမှ အနုတ်ထုတ်ပါ
- ပထမဆုံး run တွင် build process အနည်းငယ်နှေးကွေးနိုင်သည် (npm install, Vite build)
## Security Considerations
### Environment Variables
- API keys များကို repository တွင် မတင်ပါနှင့်
- `.env` ဖိုင်များ အသုံးပြုပါ ( `.gitignore` ထဲတွင်ဖြစ်ပြီး)
- project README များတွင် လိုအပ်သော environment variables များ စာရင်းသွင်းပါ
- API ကီးများကို Repository တွင် commit မပြုလုပ်သင့်ပါ
- `.env` ဖိုင်များကို အသုံးပြုပါ (သည်နောက် `.gitignore` တွင် ပါဝင်သည်)
- လိုအပ်သည့် environment variable များကို project README များတွင် ဖော်ပြပါ
### Python Projects
- Virtual environment အသုံးပြုရန်: `python -m venv venv`
- dependency များ ပြောင်းလဲမှုရှိ သော်လည်း အဆင့်မြှင့်တင်ထားပါ
- GitHub tokens များသည် အနည်းဆုံးလိုအပ်သော ခွင့်များသာ ရှိပါစေရန်
- virtual environment သုံးပါ - `python -m venv venv`
- dependencies များကို သက်တမ်းမကုန်ရှင်းစွာ သိမ်းဆည်းပါ
- GitHub tokens များသည် လိုအပ်ဆုံးအမြင့်ဆုံး ခွင့်ပြုချက်သာ ပေးပါ
### GitHub Models Access
- Personal Access Tokens (PAT) အတွက် GitHub Models အသုံးပြုရန်လိုအပ်သည်
- Tokens များကို environment variables အဖြစ် သိမ်းဆည်းထားပါ
- Tokens သို့မဟုတ် credentials များ ကို ဘဲ commit မလုပ်ပါနှင့်
- Personal Access Tokens (PATs) မရှိမဖြစ်လိုအပ်ပါသည်
- tokens များကို environment variables အဖြစ် သိမ်းဆည်းရမည်
- tokens သို့မဟုတ် လျှို့ဝှက်ချက် မလုပ်ထုတ်သင့်ပါ
## Additional Notes
### Target Audience
- ဝဘ်ဖွံ့ဖြိုးတိုးတက်ရေး အထူးစတင်သူများ
- ကျောင်းသားများနှင့် ကိုယ်တိုင်သင်ယူသူများ
- သင်တန်းဆရာများ စတင်သင်ကြားရာတွင် အသုံးပြုသူများ
- အရည်အသွေးမြှင့်တင်ရေး အတွက် အသေးစားနည်းလမ်းဖြင့် ဖန်တီးထားသောအကြောင်းအရာ
- web development စတင်သင်ယူမှု လူသစ်များ
- ကျောင်းသားများနှင့် ကိုယ်တိုင် သင်ယူသူများ
- သင်ရိုးညွှန်းတမ်းကို စာသင်ခန်းများတွင် အသုံးပြုသော ဆရာမများ
- အားလုံးအတွက် ဝင်ရောက် ချ Easy လွယ်အောင် ထားရှိခြင်းနှင့် အဆင့်ဆင့် ကျွမ်းကျင်မှု တိုးတက်စေခြင်း
### Educational Philosophy
- ပရောဂျက်အခြေပြု သင်ကြားမှု ပြုလုပ်ခြင်း
- မေးပွဲများမှတဆင့် သိမှုစစ်ဆေးခြင်း
- လက်တွဲကူညီ လေ့ကျင့်ခန်းမျာ
- လက်တွေ့ အသုံးပြုမှု ဥပမာများ
- Framework မတိုင်မီ အခြေခံများကို ဦးစားပေးသင်ကြားခြင်း
- ပရောဂျက်အခြေပြု သင်ကြားမှုနည်းလမ်း
- Knowledge checks (quizzes) များအားသက်တမ်းမတိုအောင် ကြာလတီစွာ ခြေရာခံခြင်း
- လက်တွေ့ ကုဒ်ရေးစမ်းသပ်ခြင်
- အမှန်တကယ် အသုံးချနိုင်သော နမူနာများ
- framework မတိုင်မီ အခြေခံအမြင်ကို အထူးပြုခြင်း
### Repository Maintenance
- သင်ယူသူများနှင့် ပါဝင်သူများ ပိုမိုတက်ကြွသော လူထုစုစည်းမှု
- Dependencies နှင့် အကြောင်းအရာများ ပုံမှန် ပြုပြင်ထားခြင်း
- ပြဿနာများနှင့် ဆွေးနွေးမှုများ စောင့်ကြည့်မှုဖြင့် ထိန်းသိမ်းမှု
- ဘာသာပြန်ခြင်းအား GitHub Actions ဖြင့် အလိုအလျောက် ပြုလုပ်မှု
- သင်ယူသူများနှင့် အထောက်အပံ့ပေးသူများ အဖွဲ့အစည်း စတက်ရောက်နေသည်
- dependencies နှင့် အကြောင်းအရာများ ပုံမှန် ပြင်ဆင် ပြောင်းလဲမှုများလုပ်သည်
- issue များနှင့် ဆွေးနွေးမှုများ စောင့်ကြည့်သူများရှိသည်
- ဘာသာပြန်မှု update များကို GitHub Actions ဖြင့် အလိုအလျောက်လုပ်ဆောင်သည်
### Related Resources
- [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) သည် သင်ယူသူများအတွက် အတူတူအသုံးပြုရန် ဖြစ်သည်
- အပိုသင်တန်းများဖြစ်သည့် Generative AI, Data Science, ML, IoT သင်ရိုးများ ရရှိနိုင်ပါသည်
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) ကို သင်ယူသူများအတွက် အကြံပြုသည်
- အပို သင်တန်းများ - Generative AI, Data Science, ML, IoT သင်ရိုးညွှန်းတမ်းများရရှိနိုင်သည်
### Working with Specific Projects
သီးခြား project များအတွက် အသေးစိတ် လမ်းညွှန်ချက်များကို အောက်ပါ README ဖိုင်များတွင် ပြန်လည်ကြည့်ရှုနိုင်သည်-
- `quiz-app/README.md` - Vue 3 quiz လျှောက်လွှာ
- `7-bank-project/README.md` - အတည်ပြု authentication ပါဝင်သည့် ဘဏ်လုပ်ငန်း လျှောက်လွှာ
- `5-browser-extension/README.md` - Browser Extension ဖန်တီးခြင်း
- `6-space-game/README.md` - Canvas အခြေပြုဂိမ်း ဖန်တီးခြင်း
အသေးစိတ် ညွှန်ကြားချက်များအတွက် အောက်ပါ README ဖိုင်များ ကြည့်ပါ -
- `quiz-app/README.md` - Vue 3 quiz application
- `7-bank-project/README.md` - အသုံးပြုခွင့်ရှိပြီး banking app
- `5-browser-extension/README.md` - Browser extension ဖွံ့ဖြိုးမှု
- `6-space-game/README.md` - Canvas အပေါ်အခြေခံထားသောဂိမ်းဖန်တီးမှု
- `9-chat-project/README.md` - AI chat assistant ပရောဂျက်
### Monorepo Structure
ယင်းတွင် အမှန်တကယ် Monorepo မဟုတ်ပါ၊ သို့သော် မတူညီသည့် ပရောဂျက်များ အများကြီး ပါဝင်သည့် repository ဖြစ်သည်-
- အတှကျ သင်ခန်းစာ တစ်ခုချင်းစီ သီးခြားဖြစ်သည်
- ထိုပရောဂျက်များတွင် dependency မျှဝေမှုမရှိပါ
- တစ်ခုချင်း project များအပေါ် ပြုလုပ်ရာတွင် တစ်ခုတည်းကို အကျိုးသက်ရောက်မှု မရှိစေရန် လုပ်ဆောင်နိုင်သည
- လုံးဝသင်ရိုးအတက် အတွေ့အကြုံရှိစေရန် repository အားလုံးကို clone လုပ်နိုင်သည်
ရိုးရာ monorepo မဟုတ်သော်လည်း ဖိုင်တိုက်တွင် ပရောဂျက်များ မျိုးစုံ ပါသည် -
- သင်ခန်းစာတိုင်းမှာ ကိုယ်ပိုင် လွတ်လပ်မှုရှိသည်
- ပရောဂျက်များသည် အချင်းချင်း အသုံးပြုသော dependencies များ မမျှမျှဝေပါ
- သီးသန့်ပရောဂျက်အား လုပ်ကိုင်ပြီး အခြားပရောဂျက်များအပေါ် သက်ရောက်မှုမရှိစေရန
- အပြည့်အစုံ သင်ရိုးရှိမှုအတွက် အားလုံးကို clone လုပ်ပါ
---
<!-- 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 -->

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T10:14:20+00:00",
"translation_date": "2026-02-06T12:02:33+00:00",
"source_file": "AGENTS.md",
"language_code": "sl"
},

@ -2,64 +2,64 @@
## Pregled projekta
To je izobraževalno skladišče kurikuluma za učenje osnov spletnega razvoja za začetnike. Kurikulum je obsežen 12-tedenski tečaj, ki ga je razvil Microsoft Cloud Advocates in vsebuje 24 praktičnih lekcij o JavaScriptu, CSS-u in HTML-u.
To je repozitorij izobraževalnega kurikuluma za učenje osnov spletnega razvoja za začetnike. Kurikulum je obsežen 12-tedenski tečaj, ki ga je razvilo Microsoft Cloud Advocates, z 24 praktičnimi lekcijami, ki pokrivajo JavaScript, CSS in HTML.
### Ključne sestavine
### Ključne komponente
- **Izobraževalna vsebina**: 24 strukturiranih lekcij organiziranih v modulih na osnovi projektov
- **Praktični projekti**: Terrarium, Typing Game, Razširitev brskalnika, Space Game, Banking App, Urejevalnik kode in AI Chat Assistant
- **Interaktivni kvizi**: 48 kvizov s po 3 vprašanji (pred/post-ocenjevanje lekcij)
- **Podpora za več jezikov**: Samodejni prevodi v več kot 50 jezikov preko GitHub Actions
- **Izobraževalna vsebina**: 24 strukturiranih lekcij, organiziranih v module, osnovane na projektih
- **Praktični projekti**: Terrarium, Igra tipkanja, Razširitev brskalnika, Igra vesolja, Bančna aplikacija, Urejevalnik kode in AI klepetalni asistent
- **Interaktivni kvizi**: 48 kvizov s po 3 vprašanji (pred- in po-lekcijski preizkusi)
- **Podpora več jezikom**: Avtomatizirani prevodi za več kot 50 jezikov preko GitHub Actions
- **Tehnologije**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (za AI projekte)
### Arhitektura
- Izobraževalno skladišče z lekcijsko zasnovo
- Vsaka mapa lekcije vsebuje README, primer kode in rešitve
- Izobraževalni repozitorij z lekcijsko strukturo
- Vsaka mapa lekcij vsebuje README, kode primere in rešitve
- Samostojni projekti v ločenih imenikih (quiz-app, različni lekcijski projekti)
- Sistem prevajanja z uporabo GitHub Actions (co-op-translator)
- Dokumentacija strežena preko Docsify in na voljo kot PDF
- Sistem prevajanja preko GitHub Actions (co-op-translator)
- Dokumentacija na voljo preko Docsify in kot PDF
## Ukazi za namestitev
## Ukazi za nastavitev
To skladišče je namenjeno predvsem za izobraževalno porabo vsebin. Za delo s specifičnimi projekti:
Ta repozitorij je namenjen predvsem za uporabo izobraževalne vsebine. Za delo z določenimi projekti:
### Glavna nastavitev skladišča
### Nastavitev glavnega repozitorija
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### Nastavitev Quiz Aplikacije (Vue 3 + Vite)
### Nastavitev Quiz App (Vue 3 + Vite)
```bash
cd quiz-app
npm install
npm run dev # Zaženi razvojni strežnik
npm run dev # Začni razvojni strežnik
npm run build # Zgradi za produkcijo
npm run lint # Zaženi ESLint
```
### API za Bankarski projekt (Node.js + Express)
### Bančni API projekt (Node.js + Express)
```bash
cd 7-bank-project/api
npm install
npm start # Zaženi API strežnik
npm run lint # Zaženi ESLint
npm run format # Formatiraj s Prettierjem
npm run format # Oblikuj s Prettierjem
```
### Projekti razširitev brskalnika
### Projekti razširitve brskalnika
```bash
cd 5-browser-extension/solution
npm install
# Sledite navodilom za nalaganje razširitve, ki so specifična za brskalnik
# Sledite navodilom za nalaganje razširitev, specifičnih za brskalnik
```
### Projekti Space Game
### Projekti igre vesolja
```bash
cd 6-space-game/solution
@ -67,104 +67,104 @@ npm install
# Odprite index.html v brskalniku ali uporabite Live Server
```
### Chat projekt (Python backend)
### Klepetalni projekt (Python backend)
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# Nastavite spremenljivko okolja GITHUB_TOKEN
# Nastavi okoljsko spremenljivko GITHUB_TOKEN
python api.py
```
## Razvojni potek
### Za prispevavce vsebin
### Za prispevatele vsebine
1. **Forkajte skladišče** na svoj GitHub račun
2. **Klonirajte svoj fork** lokalno
3. **Ustvarite novo vejo** za svoje spremembe
4. Spreminjajte vsebino lekcije ali primere kode
5. Preizkusite spremembe v relevantnih projektnih mapah
6. Pošljite pull requeste skladno s pravili prispevkov
1. **Razvezi repozitorij** na svoj GitHub račun
2. **Nakloni svoj razvejani repozitorij** lokalno
3. **Ustvari novo vejo** za svoje spremembe
4. Spremeni lekcijsko vsebino ali kode primere
5. Testiraj spremembe kode v ustreznih projektnih mapah
6. Pošlji pull requeste v skladu s pravili prispevkov
### Za učence
1. Forkajte ali klonirajte skladišče
2. Zaporedno se pomikajte skozi lekcijske mape
3. Preberite datoteke README za vsako lekcijo
4. Opravite pred-lekcijske kvize na https://ff-quizzes.netlify.app/web/
5. Izvedite primere kode v lekcijskih mapah
6. Opravite domače naloge in izzive
7. Opravite post-lekcijske kvize
1. Razvezi ali nakloni repozitorij
2. Postopno pojdi skozi mape lekcij
3. Preberi README datoteke za vsako lekcijo
4. Izpolni pred-lekcijske kvize na https://ff-quizzes.netlify.app/web/
5. Delo po primerih kode v lekcijskih mapah
6. Reši naloge in izzive
7. Izpolni po-lekcijske kvize
### Razvoj v živo
### Živ razvoj
- **Dokumentacija**: Zaženite `docsify serve` v korenskem imeniku (port 3000)
- **Quiz Aplikacija**: Zaženite `npm run dev` v imeniku quiz-app
- **Projekti**: Uporabite razširitev VS Code Live Server za HTML projekte
- **API Projekti**: Zaženite `npm start` v ustreznih API imenikih
- **Dokumentacija**: Zaženi `docsify serve` v korenskem imeniku (vrata 3000)
- **Quiz App**: Zaženi `npm run dev` v mapi quiz-app
- **Projekti**: Uporabi VS Code Live Server razširitev za HTML projekte
- **API projekti**: Zaženi `npm start` v ustreznih API mapah
## Navodila za testiranje
### Testiranje Quiz aplikacije
### Testiranje Quiz App
```bash
cd quiz-app
npm run lint # Preveri težave s slogom kode
npm run build # Preveri, da je gradnja uspešna
npm run build # Preveri, ali je izdelava uspešna
```
### Testiranje Bank API
```bash
cd 7-bank-project/api
npm run lint # Preveri težave s slogom kode
npm run lint # Preveri morebitne težave s slogom kode
node server.js # Preveri, ali se strežnik zažene brez napak
```
### Splošen pristop testiranja
### Splošen pristop k testiranju
- To je izobraževalno skladišče brez obsežnih avtomatiziranih testov
- Ročno testiranje se osredotoča na:
- Koda se izvaja brez napak
- Gre za izobraževalni repozitorij brez celovitih avtomatiziranih testov
- Ročno testiranje fokusira na:
- Kode primere delujejo brez napak
- Povezave v dokumentaciji delujejo pravilno
- Projekti se uspešno zgradijo
- Primeri sledijo dobrim praksam
- Primeri sledijo najboljšim praksam
### Preverjanja pred oddajo
### Kontrole pred oddajo
- Zaženite `npm run lint` v imenikih z package.json
- Preverite, da so markdown povezave veljavne
- Preizkusite primere kode v brskalniku ali Node.js
- Preverite, da prevodi ohranjajo pravilno strukturo
- Zaženi `npm run lint` v mapah s package.json
- Preveri, da so oznake v markdown povezavah veljavne
- Testiraj kode primere v brskalniku ali Node.js
- Preveri, da prevodi ohranjajo pravilno strukturo
## Smernice za slog kode
### JavaScript
- Uporabljajte sodobno sintakso ES6+
- Sledite standardnim konfiguracijam ESLint v projektih
- Uporabljajte smiselna imena spremenljivk in funkcij za jasnost
- Dodajte komentarje, ki razlagajo pojme za učence
- Formatirajte s Prettier, kjer je nastavljeno
- Uporabljaj sodobno ES6+ sintakso
- Sledi standardnim ESLint konfiguracijam, ki so v projektih
- Uporabljaj pomenljive imena spremenljivk in funkcij za jasno učenje
- Dodaj komentarje za razlago konceptov učencem
- Oblikuj po Prettier kjer je konfiguriran
### HTML/CSS
- Semantični HTML5 elementi
- Principi odzivnega oblikovanja
- Jasne konvencije za poimenovanje razredov
- Komentarji, ki pojasnjujejo CSS tehnike za učence
- Principi odzivnega dizajna
- Jasne konvencije imenovanja razredov
- Komentarji, ki razlagajo CSS tehnike za učence
### Python
- Smernice sloga PEP 8
- Jasni, izobraževalni primeri kode
- Tipizacije, kjer so koristne za učenje
- Jasni, izobraževalni kode primeri
- Tipni namigi tam, kjer so uporabni za učenje
### Markdown dokumentacija
- Jasna hierarhija naslovov
- Bloki kode z navedbo jezika
- Bloki kode z določanjem jezika
- Povezave do dodatnih virov
- Posnetki zaslona in slike v mapah `images/`
- Alt besedilo za slike za dostopnost
@ -172,111 +172,111 @@ node server.js # Preveri, ali se strežnik zažene brez napak
### Organizacija datotek
- Lekcije oštevilčene zaporedno (1-getting-started-lessons, 2-js-basics, itd.)
- Vsak projekt ima mape `solution/` in pogosto `start/` ali `your-work/`
- Slike shranjene v lekcijsko specifičnih mapah `images/`
- Prevodi v strukturi `translations/{language-code}/`
- Vsak projekt ima `solution/` in pogosto `start/` ali `your-work/` mape
- Slike shranjene v lekcijsko specifičnih `images/` mapah
- Prevodi v `translations/{language-code}/` strukturi
## Izgradnja in nameščanje
## Gradnja in implementacija
### Namestitev Quiz aplikacije (Azure Static Web Apps)
### Implementacija Quiz App (Azure Static Web Apps)
Quiz-aplikacija je konfigurirana za nameščanje na Azure Static Web Apps:
Quiz-app je konfiguriran za implementacijo Azure Static Web Apps:
```bash
cd quiz-app
npm run build # Ustvari mapo dist/
# Izvede nameščanje prek GitHub Actions delovnega toka ob potisku v main
# Izvede namestitev preko GitHub Actions delovnega toka ob pushu na main
```
Konfiguracija Azure Static Web Apps:
- **Lokacija aplikacije**: `/quiz-app`
- **Izhodna lokacija**: `dist`
- **Lokacija izhoda**: `dist`
- **Delovni tok**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Generiranje PDF dokumentacije
```bash
npm install # Namestite docsify-to-pdf
npm run convert # Ustvari PDF iz docs
npm run convert # Ustvarite PDF iz docs
```
### Dokumentacija Docsify
```bash
npm install -g docsify-cli # Namestite Docsify globalno
docsify serve # Postrezite na localhost:3000
docsify serve # Postrežite na localhost:3000
```
### Specifične gradnje projektov
### Gradnje specifične za projekt
Vsaka projektna mapa ima lahko lasten postopek gradnje:
- Vue projekti: `npm run build` ustvarja produkcijske pakete
- Statični projekti: brez gradnje, datoteke strežete neposredno
Vsaka projektna mapa ima lahko svoj build proces:
- Vue projekti: `npm run build` ustvari produkcijske pakete
- Statični projekti: brez gradnje, datoteke streže neposredno
## Pravila za pull requeste
### Oblika naslova
### Format naslova
Uporabljajte jasne, opisne naslove, ki kažejo področje spremembe:
Uporabi jasne, opisne naslove, ki označujejo področje spremembe:
- `[Quiz-app] Dodaj nov kviz za lekcijo X`
- `[Lesson-3] Popravi tipkarsko napako v terrarium projektu`
- `[Lesson-3] Popravi tipkarsko napako v projektu terrarium`
- `[Translation] Dodaj španski prevod za lekcijo 5`
- `[Docs] Posodobitev navodil za namestitev`
- `[Docs] Posodobi navodila za namestitev`
### Zahtevane kontrole
### Obvezne kontrole
Pred oddajo PR:
Pred pošiljanjem PR:
1. **Kakovost kode**:
- Zaženite `npm run lint` v prizadetih imenikih
- Odpravite vse napake in opozorila
- Zaženi `npm run lint` v prizadetih projektnem mapah
- Odpravi vse napake in opozorila
2. **Preverjanje gradnje**:
- Zaženite `npm run build`, če je potrebno
- Zagotovite, da ni napak pri gradnji
- Zaženi `npm run build`, če je potrebno
- Poskrbi, da ni napak pri gradnji
3. **Preverjanje povezav**:
- Testirajte vse markdown povezave
- Preverite delovanje referenc slik
- Preizkusi vse markdown povezave
- Potrdi, da reference slik delujejo
4. **Pregled vsebine**:
- Preverite pravopis in slovnico
- Zagotovite pravilnost in izobraževalno vrednost primerov kode
- Preverite, da prevodi ohranjajo prvotni pomen
- Preveri črkovanje in slovnico
- Zagotovi pravilnost in poučnost kode primerov
- Preveri, da prevodi ohranjajo prvotni pomen
### Zahteve za prispevek
- Strinjajte se z Microsoft CLA (avtomatska kontrola ob prvem PR)
- Sledite [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Oglejte si [CONTRIBUTING.md](./CONTRIBUTING.md) za podrobna navodila
- V opisu PR navedite številke issuejev, kjer je primerno
- Sprejmi Microsoft CLA (samodejni pregled ob prvem PR)
- Sledi [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Preglej [CONTRIBUTING.md](./CONTRIBUTING.md) za podrobna pravila
- V opisu PR navajaj številke issue-jev, če je potrebno
### Postopek pregleda
### Proces pregleda
- PR-e pregledajo vzdrževalci in skupnost
- Prioriteta je izobraževalna jasnost
- Primeri kode naj sledijo trenutnim najboljšim praksam
- Prevodi pregledani zaradi natančnosti in kulturne ustreznosti
- PR pregledujejo vzdrževalci in skupnost
- Prednost ima jasnost za učenje
- Code primere naj sledijo najboljšim praksam
- Prevode pregledajo glede natančnosti in ustreznosti
## Sistem prevajanja
### Avtomatski prevod
### Avtomatiziran prevod
- Uporablja GitHub Actions z delovnim tokov co-op-translator
- Uporablja GitHub Actions s co-op-translator delovnim tokom
- Samodejno prevaja v več kot 50 jezikov
- Izvorne datoteke v glavnih imenikih
- Prevedene datoteke v mapah `translations/{language-code}/`
- Izvorne datoteke v glavnih mapah
- Prevedene datoteke v `translations/{language-code}/` mapah
### Dodajanje ročnih izboljšav prevoda
1. Poiščite datoteko v `translations/{language-code}/`
2. Izboljšajte vsebino, ohranjajte strukturo
3. Zagotovite delovanje primerov kode
4. Testirajte lokalizirano vsebino kviza
1. Poišči datoteko v `translations/{language-code}/`
2. Izboljšaj prevod ob ohranitvi strukture
3. Poskrbi, da so primeri kode še vedno funkcionalni
4. Testiraj lokalizirano vsebino kviza
### Metapodatki prevoda
Prevedene datoteke vsebujejo glavo z metapodatki:
Prevedene datoteke vključujejo meta podatkovni glavi:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
-->
```
## Razhroščevanje in odpravljanje težav
## Odpravljanje napak in reševanje težav
### Pogoste težave
**Quiz aplikacija se ne zažene**:
- Preverite verzijo Node.js (priporočeno v14+)
- Izbrišite `node_modules` in `package-lock.json`, nato zaženite `npm install`
- Preverite konflikte vrat (privzeto: Vite uporablja port 5173)
**Quiz app se ne zažene**:
- Preveri verzijo Node.js (priporočeno v14+)
- Izbriši `node_modules` in `package-lock.json`, nato zaženi `npm install`
- Preveri konflikte vrat (privzeto: Vite uporablja vrata 5173)
**API strežnik se ne zažene**:
- Preverite, da je verzija Node.js >=10
- Preverite, če vrata že niso v uporabi
- Zagotovite, da so vse odvisnosti nameščene z `npm install`
- Preveri, če je Node.js verzija vsaj 10 ali višja
- Preveri, ali vrat že niso zasedena
- Zagotovi, da so vse odvisnosti nameščene z `npm install`
**Razširitev brskalnika se ne naloži**:
- Preverite pravilnost formata manifest.json
- Preglejte konzolo brskalnika za napake
- Upoštevajte navodila za namestitev razširitve za določen brskalnik
- Preveri, ali je manifest.json pravilno oblikovan
- Preveri konzolo brskalnika za napake
- Sledi navodilom za namestitev razširitve za določen brskalnik
**Težave s Python chat projektom**:
- Preverite, da je nameščen OpenAI paket: `pip install openai`
- Preverite, da je nastavljena okoljska spremenljivka GITHUB_TOKEN
- Preverite dovoljenja za dostop do GitHub modelov
**Težave s Python klepetalnim projektom**:
- Preveri, da je paket OpenAI nameščen: `pip install openai`
- Preveri, da je okoljska spremenljivka GITHUB_TOKEN nastavljena
- Preveri pravice dostopa do GitHub modelov
**Docsify ne streže dokumentacije**:
- Namestite docsify-cli globalno: `npm install -g docsify-cli`
- Zaženite v korenskem imeniku skladišča
- Preverite, da obstaja `docs/_sidebar.md`
- Namesti docsify-cli globalno: `npm install -g docsify-cli`
- Zaženi iz korenskega imenika repozitorija
- Preveri, da obstaja `docs/_sidebar.md`
### Nasveti za razvojno okolje
- Uporabljajte VS Code z razširitvijo Live Server za HTML projekte
- Namestite razširitve ESLint in Prettier za enotno oblikovanje
- Uporabite brskalniška orodja za razvijalce za razhroščevanje JavaScript-a
- Za Vue projekte namestite Vue DevTools razširitev za brskalnik
- Uporabljaj VS Code z Live Server razširitvijo za HTML projekte
- Namesti razširitve ESLint in Prettier za konsistentno oblikovanje
- Uporabljaj DevTools v brskalniku za razhroščevanje JavaScript
- Za Vue projekte namesti Vue DevTools razširitev za brskalnik
### Razmisleki o zmogljivosti
### Razmišljanja o zmogljivosti
- Veliko število prevedenih datotek (več kot 50 jezikov) pomeni velike klone
- Za delo le z vsebino uporabite plitek klon: `git clone --depth 1`
- Izključite prevode iz iskanja med delom na angleški vsebini
- Gradnje so lahko počasne ob prvem zagonu (npm install, Vite build)
- Veliko število prevedenih datotek (50+) pomeni, da so polne kopije velike
- Uporabi plitvo kloniranje, če delaš samo z vsebino: `git clone --depth 1`
- Izključi prevode iz iskanj pri delu z angleško vsebino
- Proces gradnje je lahko počasnejši ob prvem zagonu (npm install, Vite build)
## Varnostni vidiki
### Okoljske spremenljivke
- Nikoli ne komitirajte API ključev v repozitorij
- Uporabljajte `.env` datoteke (že v `.gitignore`)
- Dokumentirajte potrebne okoljske spremenljivke v README-jih projektov
- Ključi API nikoli ne smejo biti s pomočjo commit-a v repozitoriju
- Uporabljaj `.env` datoteke (že v `.gitignore`)
- Zahtevane okoljske spremenljivke dokumentiraj v README projektov
### Python projekti
- Uporabljajte virtualna okolja: `python -m venv venv`
- Redno posodabljajte odvisnosti
- GitHub žetoni naj imajo minimalna potrebna dovoljenja
- Uporabljaj virtualna okolja: `python -m venv venv`
- Ohrani odvisnosti posodobljene
- GitHub žetoni naj imajo minimalne potrebne pravice
### Dostop do GitHub modelov
- Za GitHub modele so potrebni osebni dostopni žetoni (PAT)
- Žetone shranjujte v okoljske spremenljivke
- Nikoli ne komitirajte žetonov ali poverilnic
- Osebni dostopni žetoni (PAT) so potrebni za GitHub modele
- Žetoni naj bodo shranjeni kot okoljske spremenljivke
- Nikoli ne nastavljaj žetonov ali poverilnic v repozitorij
## Dodatne opombe
### Ciljna publika
- Popolni začetniki pri spletnem razvoju
- Popolni začetniki v spletni razvoj
- Študentje in samouki
- Učitelji, ki uporabljajo kurikulum v učilnicah
- Vsebina je zasnovana za dostopnost in postopno gradnjo znanja
- Učitelji, ki uporabljajo kurikulum v razredih
- Vsebina je zasnovana za dostopnost in postopno pridobivanje veščin
### Filozofija izobraževanja
### Izobraževalna filozofija
- Pristop učenja na osnovi projektov
- Pristop učenja preko projektov
- Pogoste preveritve znanja (kvizi)
- Praktične vaje programiranja
- Primeri uporabe v realnem svetu
- Osredotočenost na osnove pred ogrodji
- Praktične vaje s kodiranjem
- Resnični primeri uporabe
- Osredotočanje na osnove pred okvirji
### Vzdrževanje skladišča
### Vzdrževanje repozitorija
- Aktivna skupnost učencev in prispevavcev
- Aktivna skupnost učencev in prispevkov
- Redne posodobitve odvisnosti in vsebine
- Vzdrževalci spremljajo issueje in razprave
- Posodobitve prevodov avtomatizirane z GitHub Actions
- Spremljanje težav in razprav s strani vzdrževalcev
- Avtomatizirane posodobitve prevodov preko GitHub Actions
### Povezani viri
### Sorodni viri
- [Microsoft Learn moduli](https://docs.microsoft.com/learn/)
- [Student Hub viri](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) priporočeno za učence
- Dodatni tečaji: Generativna AI, Podatkovna znanost, ML, IoT kurikulumi na voljo
- [Moduli Microsoft Learn](https://docs.microsoft.com/learn/)
- [Viri Student Hub](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) priporočen za učence
- Dodatni tečaji: Generativna AI, Data Science, ML, IoT kurikulumi na voljo
### Delo s specifičnimi projekti
### Delo z določenimi projekti
Za podrobna navodila o posameznih projektih si oglejte README datoteke:
- `quiz-app/README.md` - Vue 3 quiz aplikacija
- `7-bank-project/README.md` - Bančniška aplikacija z avtentikacijo
- `5-browser-extension/README.md` - Razvoj razširitev za brskalnik
- `6-space-game/README.md` - Razvoj igre na osnovi canvas-a
- `9-chat-project/README.md` - Projekt AI chat asistenta
Za podrobna navodila o posameznih projektih glej README datoteke v:
- `quiz-app/README.md` - Vue 3 aplikacija za kvize
- `7-bank-project/README.md` - Bančna aplikacija z avtentikacijo
- `5-browser-extension/README.md` - Razvoj brskalniške razširitve
- `6-space-game/README.md` - Razvoj igre na platnu (canvas)
- `9-chat-project/README.md` - AI klepetalni asistent
### Struktura monorepo skladišča
### Struktura monorepoja
Čeprav ni tradicionalni monorepo, to skladišče vsebuje več samostojnih projektov:
Čeprav ni tradicionalni monorepo, ta repozitorij vsebuje več samostojnih projektov:
- Vsaka lekcija je samostojna
- Projekti ne delijo odvisnosti
- Projekti ne uporabljajo skupnih odvisnosti
- Delo na posameznih projektih brez vpliva na druge
- Klonirajte celotno skladišče za celoten kurikulum
- Nakloni celoten repozitorij za popolno izkušnjo kurikuluma
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Omejitev odgovornosti**:
Ta dokument je bil preveden z uporabo AI prevajalske storitve [Co-op Translator](https://github.com/Azure/co-op-translator). Čeprav si prizadevamo za natančnost, vas prosimo, da upoštevate, da avtomatizirani prevodi lahko vsebujejo napake ali netočnosti. Izvirni dokument v izvorni jezik velja za uradni vir. Za kritične informacije priporočamo strokoven človeški prevod. Za morebitne nesporazume ali napačne interpretacije, ki izhajajo iz uporabe tega prevoda, ne prevzemamo odgovornosti.
**Omejitev odgovornosti**:
Ta dokument je bil preveden z uporabo AI prevajalske storitve [Co-op Translator](https://github.com/Azure/co-op-translator). Čeprav si prizadevamo za natančnost, vas prosimo, da upoštevate, da avtomatski prevodi lahko vsebujejo napake ali netočnosti. Izvirni dokument v njegovem izvirnem jeziku velja za avtoritativni vir. Za ključne informacije je priporočljivo uporabiti strokovni človeški prevod. Nismo odgovorni za morebitna nesporazume ali napačne interpretacije, ki izhajajo iz uporabe tega prevoda.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->
Loading…
Cancel
Save