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

pull/1690/head
localizeflow[bot] 3 weeks ago
parent 75e8cf5f1e
commit 554f8750c7

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

@ -2,29 +2,29 @@
## Pregled projekta
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.
Ovo je edukacijski repozitorij za podučavanje osnova web razvoja početnicima. Kurikulum je sveobuhvatan tečaj u trajanju od 12 tjedana koji je razvijen od strane Microsoft Cloud Advocatesa, a sadrži 24 praktične lekcije koje pokrivaju JavaScript, CSS i HTML.
### Ključne komponente
- **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
- **Praktični projekti**: Terrarij, Igra tipkanja, Proširenje za preglednik, Svemirska igra, Bankarska aplikacija, Uređivač koda i AI chat asistent
- **Interaktivni kvizovi**: 48 kvizova sa po 3 pitanja (procjena prije i poslije lekcije)
- **Podrška za više jezika**: Automatska prijevodi za više od 50 jezika putem GitHub Actions
- **Tehnologije**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (za AI projekte)
### Arhitektura
- Edukativni repozitorij sa strukturom zasnovanom na lekcijama
- Edukativni repozitorij sa strukturom baziranom 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 koristeći GitHub Actions (co-op-translator)
- Dokumentacija poslužena putem Docsify i dostupna kao PDF
- Samostalni projekti u zasebnim direktorijima (quiz-app, različiti projekti lekcija)
- Sustav prevođenja koristeći GitHub Actions (co-op-translator)
- Dokumentacija se posluživava preko Docsify-a i dostupna je kao PDF
## Komande za postavljanje
Ovaj repozitorij je prvenstveno za konzumaciju edukativnog sadržaja. Za rad sa specifičnim projektima:
Ovaj repozitorij je primarno za konzumaciju edukativnog sadržaja. Za rad s određenim projektima:
### Postavljanje glavnog repozitorija
### Glavno postavljanje repozitorija
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
@ -37,7 +37,7 @@ cd Web-Dev-For-Beginners
cd quiz-app
npm install
npm run dev # Pokreni razvojni poslužitelj
npm run build # Izgradi za produkciju
npm run build # Izradi za produkciju
npm run lint # Pokreni ESLint
```
@ -51,15 +51,15 @@ npm run lint # Pokreni ESLint
npm run format # Formatiraj s Prettierom
```
### Projekti proširenja za preglednik
### Projekti Proširenja za preglednik
```bash
cd 5-browser-extension/solution
npm install
# Slijedite upute za učitavanje proširenja specifične za preglednik
# Slijedite upute za učitavanje proširenja specificirane za preglednik
```
### Projekti svemirske igre
### Projekti Svemirske igre
```bash
cd 6-space-game/solution
@ -72,35 +72,35 @@ npm install
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# Postavite varijablu okoline GITHUB_TOKEN
# Postavite varijablu okruženja GITHUB_TOKEN
python api.py
```
## Radni tijek razvoja
## Radni proces razvoja
### Za suradnike na sadržaju
1. **Napravite fork repozitorija** na svoj GitHub račun
2. **Klonirajte fork** lokalno
3. **Kreirajte novu granu** za vaše izmjene
1. **Forkajte repozitorij** na svoj GitHub račun
2. **Klonirajte svoj fork** lokalno
3. **Kreirajte novu granu** za svoje promjene
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
5. Testirajte bilo kakve izmjene koda u relevantnim direktorijima projekata
6. Pošaljite pull request-e u skladu s uputama za doprinos
### Za učenike
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
1. Forkajte ili klonirajte repozitorij
2. Posjećujte direktorije lekcija redom
3. Čitajte README datoteke za svaku lekciju
4. Riješite pred-lekcijske kvizove na https://ff-quizzes.netlify.app/web/
5. Radite kroz primjere koda u mapama lekcija
6. Završite zadatke i izazove
7. Riješite post-lesson kvizove
7. Riješite post-lekcijske kvizove
### Live razvoj
### Živi razvoj
- **Dokumentacija**: Pokrenite `docsify serve` u korijenu (port 3000)
- **Quiz App**: Pokrenite `npm run dev` unutar direktorija quiz-app
- **Dokumentacija**: Pokrenite `docsify serve` u root direktoriju (port 3000)
- **Quiz App**: Pokrenite `npm run dev` u quiz-app direktoriju
- **Projekti**: Koristite VS Code Live Server ekstenziju za HTML projekte
- **API projekti**: Pokrenite `npm start` u odgovarajućim API direktorijima
@ -110,33 +110,33 @@ python api.py
```bash
cd quiz-app
npm run lint # Provjeri probleme sa stilom koda
npm run build # Provjeri uspjeh kompilacije
npm run lint # Provjerite probleme sa stilom koda
npm run build # Potvrdite da izgradnja uspijeva
```
### Testiranje Bank API-ja
### Testiranje Bankovnog API-ja
```bash
cd 7-bank-project/api
npm run lint # Provjeri probleme sa stilom koda
node server.js # Provjeri pokretanje servera bez grešaka
npm run lint # Provjerite ima li problema sa stilom koda
node server.js # Provjerite pokreće li se server bez grešaka
```
### Opći pristup testiranju
- Ovo je edukativni repozitorij bez opsežnih automatiziranih testova
- Ovaj repozitorij je edukativan i nema opsežne automatizirane testove
- Ručno testiranje se fokusira na:
- Primjere koda koji se izvršavaju bez grešaka
- Ispravnost linkova u dokumentaciji
- Uspješno dovršenje izgradnje projekata
- Primjeri poštuju najbolje prakse
- Pokretanje primjera koda bez pogrešaka
- Ispravnost veza u dokumentaciji
- Uspješnu izgradnju projekata
- Primjere koji slijede najbolje prakse
### Provjere prije predaje
### Provjere prije slanja
- Pokrenite `npm run lint` u direktorijima s package.json
- Provjerite valjanost markdown linkova
- Testirajte primjere koda u pregledniku ili Node.js
- Provjerite da prijevodi održavaju ispravnu strukturu
- Provjerite očuvanost strukture prijevoda
## Smjernice za stil koda
@ -144,54 +144,54 @@ node server.js # Provjeri pokretanje servera bez grešaka
- Koristite modernu ES6+ sintaksu
- Slijedite standardne ESLint konfiguracije u projektima
- Koristite smislena imena varijabli i funkcija radi edukativne jasnoće
- Koristite smisleno imenovanje varijabli i funkcija radi edukativne jasnoće
- Dodajte komentare koji objašnjavaju koncepte za učenike
- Formatirajte pomoću Prettier gdje je konfigurirano
- Formatirajte kod koristeći Prettier gdje je konfigurirano
### HTML/CSS
- Semantički HTML5 elementi
- Principi responzivnog dizajna
- Jasne konvencije imenovanja klasa
- Jasno imenovanje klasa
- Komentari koji objašnjavaju CSS tehnike za učenike
### Python
- Smjernice stila PEP 8
- PEP 8 smjernice stilskog pisanja
- Jasni, edukativni primjeri koda
- Tipizacija gdje je korisno za učenje
### Markdown dokumentacija
- Jasna hijerarhija naslova
- Blokovi koda s definicijom jezika
- Linkovi ka dodatnim izvorima
- Snimke zaslona i slike u direktorijima `images/`
- Blokovi koda s oznakom jezika
- Linkovi na dodatne resurse
- Screenshotti i slike u `images/` direktorijima
- Alt tekst za slike radi pristupačnosti
### Organizacija datoteka
- Lekcije numerirane sekvencijalno (1-getting-started-lessons, 2-js-basics, itd.)
- Lekcije numerirane uzlaznim redom (1-getting-started-lessons, 2-js-basics, itd.)
- Svaki projekt ima `solution/` i često `start/` ili `your-work/` direktorije
- Slike pohranjene u lekcijsko-specifičnim `images/` mapama
- Prijevodi u `translations/{language-code}/` strukturi
- Slike pohranjene u lekcijski specifičnim `images/` mapama
- Prijevodi u strukturi `translations/{jezik-kod}/`
## Izgradnja i implementacija
### Implementacija Quiz App (Azure Static Web Apps)
Quiz-app je konfiguriran za Azure Static Web Apps implementaciju:
Quiz-app je konfiguriran za implementaciju preko Azure Static Web Apps:
```bash
cd quiz-app
npm run build # Kreira dist/ mapu
# Raspoređuje putem GitHub Actions tijeka rada pri pushu na main
npm run build # Kreira mapu dist/
# Objavljuje putem GitHub Actions radnog procesa prilikom guranja na main
```
Konfiguracija Azure Static Web Apps:
- **Lokacija aplikacije**: `/quiz-app`
- **Izlazna lokacija**: `dist`
- **Radni tijek**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
- **Lokacija izlaza**: `dist`
- **Radni tok**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Generiranje PDF dokumentacije
@ -204,22 +204,22 @@ npm run convert # Generirajte PDF iz docsa
```bash
npm install -g docsify-cli # Instalirajte Docsify globalno
docsify serve # Pokrenite na localhost:3000
docsify serve # posluživanje na localhost:3000
```
### Izgradnje specifične za projekte
### Izgradnja specifična za projekte
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
- Vue projekti: `npm run build` kreira produkcijske pakete
- Statični projekti: Nema koraka izgradnje, datoteke se serviraju direktno
## Smjernice za pull requestove
## Smjernice za Pull Request
### Format naslova
Koristite jasne, opisne naslove koji označavaju područje promjene:
Koristite jasne, opisne naslove koji definiraju područje promjene:
- `[Quiz-app] Dodaj novi kviz za lekciju X`
- `[Lesson-3] Ispravi tipfeler u projektu terrarij`
- `[Lesson-3] Ispravi tipfeler u projektu terrarija`
- `[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 projektnim direktorijima
- Ispravite sve linting greške i upozorenja
- Pokrenite `npm run lint` u zahvaćenim projekt direktorijima
- Ispravite sve lint greške i upozorenja
2. **Provjera izgradnje**:
- Pokrenite `npm run build` ako je primjenjivo
- Osigurajte da nema grešaka u izgradnji
- Pokrenite `npm run build` gdje je primjenjivo
- Osigurajte da nema pogrešaka u izgradnji
3. **Provjera linkova**:
- Testirajte sve markdown linkove
- Provjerite da referenci slika rade
- Provjerite ispravnost slika
4. **Pregled sadržaja**:
- Lektura pravopisa i gramatike
- Provjerite ispravnost i edukativnost primjera koda
- Provjerite točnost i smisao prijevoda
- Provjerite pravopis i gramatiku
- Uvjerite se da su primjeri koda ispravni i edukativni
- Provjerite točnost prijevoda
### Zahtjevi za doprinos
- Prihvatite Microsoft CLA (automatska provjera prilikom prvog PR-a)
- Prihvatite Microsoft CLA (automatska provjera pri prvom PR-u)
- Slijedite [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Pogledajte [CONTRIBUTING.md](./CONTRIBUTING.md) za detaljne smjernice
- Referencirajte brojeve issues u opisu PR-a ako je primjenjivo
- Pogledajte [CONTRIBUTING.md](./CONTRIBUTING.md) za detaljne upute
- U opisu PR-a referencirajte brojeve problema ako su primjenjivi
### Proces pregleda
- PR-ovi pregledavaju održavatelji i zajednica
- PR-eve 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
- Primjeri koda trebaju slijediti najbolje prakse
- Prijevodi se pregledavaju za točnost i kulturološku prikladnost
## Sustav prijevoda
### Automatizirani prijevod
### Automatski prijevod
- Koristi GitHub Actions s co-op-translator workflowom
- Automatski prevodi na 50+ jezika
- Izvorne datoteke u glavnim direktorijima
- Prevedene datoteke u `translations/{language-code}/` direktorijima
- Koristi GitHub Actions s co-op-translator radnim tokom
- Prevodi u više od 50 jezika automatski
- Izvorne datoteke su u glavnim direktorijima
- Prevedene datoteke u `translations/{jezik-kod}/` direktorijima
### Dodavanje ručnih poboljšanja prijevoda
1. Lokacijski pronađite datoteku u `translations/{language-code}/`
2. Izvršite poboljšanja dok održavate strukturu
3. Osigurajte funkcionalnost primjera koda
1. Pronađite datoteku unutar `translations/{jezik-kod}/`
2. Napravite poboljšanja uz očuvanje strukture
3. Osigurajte da primjeri koda ostanu funkcionalni
4. Testirajte lokalizirani sadržaj kvizova
### Metapodaci prijevoda
Prevedene datoteke uključuju zaglavlje metapodataka:
Prevedene datoteke sadrže zaglavlje metapodataka:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -293,88 +293,88 @@ CO_OP_TRANSLATOR_METADATA:
### Česti problemi
**Quiz app ne može pokrenuti**:
**Quiz app se ne pokreće**:
- Provjerite verziju Node.js (preporučeno v14+)
- Obrišite `node_modules` i `package-lock.json`, pokrenite `npm install` ponovno
- Provjerite konflikte porta (zadani: Vite koristi port 5173)
- Izbrišite `node_modules` i `package-lock.json`, zatim pokrenite `npm install`
- Provjerite konflikte porta (zadano: Vite koristi port 5173)
**API server se ne pokreće**:
- Provjerite je li verzija Node.js minimalno zadovoljena (node >=10)
- Provjerite zadovoljava li verzija Node.js minimalni zahtjev (node >=10)
- Provjerite je li port već zauzet
- Provjerite jesu li sve ovisnosti instalirane s `npm install`
- Osigurajte da su sve ovisnosti instalirane s `npm install`
**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
- Provjerite ispravnost manifest.json datoteke
- Provjerite konzolu preglednika za greške
- Slijedite specifične upute za instalaciju proširenja u pregledniku
**Problemi s Python chat projektom**:
- Provjerite je li OpenAI paket instaliran: `pip install openai`
- Provjerite je li GITHUB_TOKEN varijabla okoline postavljena
- Provjerite pristup GitHub Modelima
- Osigurajte da je paket OpenAI instaliran: `pip install openai`
- Provjerite je li varijabla okoline GITHUB_TOKEN postavljena
- Provjerite pristup dozvolama za GitHub modele
**Docsify ne poslužuje dokumente**:
**Docsify ne servira dokumente**:
- Instalirajte docsify-cli globalno: `npm install -g docsify-cli`
- Pokrenite iz korijena repozitorija
- Pokrenite iz root direktorija 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 preglednika za debugging JavaScript-a
- Za Vue projekte, instalirajte Vue DevTools ekstenziju za preglednik
- Instalirajte ESLint i Prettier ekstenzije za dosljedan stil
- Koristite DevTools preglednika za debugiranje JavaScripta
- Za Vue projekte, instalirajte Vue DevTools ekstenziju u pregledniku
### Razmatranja o performansama
### Razmatranja performansi
- Veliki broj prevedenih datoteka (50+ jezika) znači da su punoklonovi veliki
- Veliki broj prevedenih datoteka (50+ jezika) znači da su puni klonovi 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
- Isključite prijevode iz pretraga kad radite na engleskom sadržaju
- Procesi izgradnje mogu biti spori pri prvom pokretanju (npm install, Vite build)
## Sigurnosna razmatranja
### Varijable okoline
- API ključevi nikada ne smiju biti commitani u repozitorij
- API ključevi nikada ne smiju biti uključeni u repozitorij
- Koristite `.env` datoteke (već u `.gitignore`)
- Dokumentirajte potrebne varijable okoline u README datotekama projekata
- Dokumentirajte potrebne varijable okoline u README-ima projekta
### Python projekti
- Koristite virtualna okruženja: `python -m venv venv`
- Održavajte ovisnosti ažuriranima
- Održavajte ovisnosti ažurnima
- GitHub tokeni trebaju imati minimalne potrebne dozvole
### Pristup GitHub Modelima
### Pristup GitHub modelima
- Potrebni su Personal Access Tokens (PAT) za GitHub Models
- Potrebni su Personal Access Token-i (PAT) za GitHub modele
- Tokeni trebaju biti pohranjeni kao varijable okoline
- Nikada nemojte commitati tokene ili vjerodajnice
- Nikada nemojte commitati tokene ili akreditive
## Dodatne napomene
### Ciljna publika
### Ciljana publika
- Potpuni početnici u web razvoju
- Studenti i samostalni učenici
- Totalni početnici u web razvoju
- Studenti i samouki
- Nastavnici koji koriste kurikulum u učionicama
- Sadržaj je dizajniran za dostupnost i postupno stjecanje vještina
- Sadržaj je dizajniran za pristupačnost i postupni razvoj vještina
### Edukativna filozofija
- Pristup učenju baziran na projektima
- Česte provjere znanja (kvizovi)
- Praktične vježbe kodiranja
- Primjeri primjene u stvarnom svijetu
- Primjeri iz stvarnog svijeta
- Fokus na osnove prije okvira
### Održavanje repozitorija
- Aktivna zajednica učenika i suradnika
- Redovita ažuriranja ovisnosti i sadržaja
- Praćenje issue-a i diskusija od strane održavatelja
- Automatizirane nadopune prijevoda putem GitHub Actions
- Redovna ažuriranja ovisnosti i sadržaja
- Problemi i diskusije se nadziru od strane održavatelja
- Ažuriranja prijevoda automatizirana preko 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 sa specifičnim projektima
### Rad s određenim projektima
Za detaljne upute o pojedinačnim projektima, pogledajte README datoteke u:
- `quiz-app/README.md` - Vue 3 aplikacija kviz
Za detaljne upute o pojedinačnim projektima pogledajte README datoteke u:
- `quiz-app/README.md` - Vue 3 aplikacija kviza
- `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 na canvasu
- `9-chat-project/README.md` - AI chat pomoćnički projekt
- `6-space-game/README.md` - Razvoj igre temeljene na Canvasu
- `9-chat-project/README.md` - AI chat asistent projekt
### Monorepo struktura
### Struktura monorepozitorija
Iako nije klasični monorepo, ovaj repozitorij sadrži više nezavisnih projekata:
Iako nije tradicionalni monorepo, ovaj repozitorij sadrži više nezavisnih projekata:
- Svaka lekcija je samostalna
- Projekti ne dijele ovisnosti
- Rad na pojedinačnim projektima bez utjecaja na druge
- Radite 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 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.
Ovaj je dokument preveden korištenjem AI usluge prevođenja [Co-op Translator](https://github.com/Azure/co-op-translator). Iako nastojimo postići točnost, 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 ključne informacije preporučuje se profesionalni ljudski prijevod. Ne snosimo odgovornost za bilo kakva nesporazumevanja ili pogreš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-06T12:04:02+00:00",
"translation_date": "2026-02-06T13:25:56+00:00",
"source_file": "AGENTS.md",
"language_code": "my"
},

@ -2,27 +2,27 @@
## Project Overview
ဤသည်မှာ web development မျိုးစွဲအခြေခံများကို စတင်သင်ကြားရန်အတွက် ပညာရေး သင်ရိုးညွှန်းတမ်း_repository_ တစ်ခုဖြစ်သည်။ သင်ရိုးညွှန်းတမ်းသည် Microsoft Cloud Advocates မှ ဖန်တီးထားသော ၁၂-ပတ်ကြာ သင်တန်းအစီအစဉ်တစ်ရပ်ဖြစ်ပြီး JavaScript၊ CSS နှင့် HTML တို့ကို ဖုံးလွှမ်းသည့် ၂၄ ခုသော လက်တွေ့သင်ခန်းစာများပါဝင်သည်။
ဤသည်မှာ ဝဘ်ဖွံ့ဖြိုးတိုးတက်ရေးအခြေခံများကို စတင်သင်ကြားလိုသူများအတွက် သင်တန်းသင်ကြားမှု သင်ရိုးစဉ်များကို ပေါင်းစပ်သိမ်းဆည်းထားသော ရှယ်ယာစာကြည့်တိုက်ဖြစ်သည်။ သင်ရိုးစဉ်သည် 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
- **င်တာရေးတက်စ် Quiz များ**: သင်ခန်းစာမတိုင်မီ/ပြီးစီးမှုပြီး ချေးမေးခွန်း ၃ မေးခွန်း ပါဝင်သည့် Quiz ၄၈ ခု
- **ဘာသာစကားများစွာကို ပံ့ပိုးမှု**: GitHub Actions ဖြင့် ၅၀ ကျော် ဘာသာစကားအလိုအလျောက်ဘာသာပြန်ခြင်း
- **နည်းပညာများ**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI ပရောဂျက်များအတွက်)
### Architecture
- သင်ခန်းစာအခြေပြု ဖိုင်တိုက်
- သင်ခန်းစာတိုင်း ဖိုလ်ဒါမှာ README, ကုဒ်ဥပမာများနှင့် ဖြေရှင်းချက်များပါဝင်သည်
- ၎င်းမှကွဲထွက်ထားသော ပရောဂျက်များ (quiz-app, အမျိုးမျိုးသော သင်ခန်းစာပရောဂျက်များ)
- GitHub Actions အသုံးပြုသော ဘာသာပြန်မှု စနစ် (co-op-translator)
- Docsify ဖြင့် မှတ်တမ်းကျော် ထုတ်ပေးပြီး PDF အနေဖြင့်လည်း ရရှိနိုင်သည်
- သင်ခန်းစာအခြေပြု ပညာရေး ရှယ်ယာစာကြည့်တိုက်
- သင်ခန်းစာတိုင်းအတွက် README, ကုဒ်နမူနာများ နှင့် ဖြေရှင်းချက်များ ပါဝင်သည်
- သီးသန့်ပရောဂျက်များကို သီးခြားဖိုင်များတွင် ထားရှိသည် (quiz-app, မတူညီသည့် သင်ခန်းစာပရောဂျက်များ)
- GitHub Actions ကို အသုံးပြုသော ဘာသာပြန်ရေးစနစ် (co-op-translator)
- Docsify ဖြင့် အတန်းစာရွက်စာတမ်းများ ကို ဝန်ဆောင်မှုပေးပြီး PDF အဖြစ် ရယူနိုင်သည်
## Setup Commands
ဖိုင်တိုက်သည် အဓိကအားဖြင့် ပညာရေးအကြောင်းအရာ အသုံးပြုမှုအတွက်ဖြစ်သည်။ အသီးသီး ပရောဂျက်များနှင့်အတူ အလုပ်လုပ်လိုပါက -
ရှယ်ယာစာကြည့်တိုက်သည် ပညာရေး အကြောင်းအရာများကို သုံးစွဲရန် အဓိကဖြစ်ပါသည်။ သီးခြား ပရောဂျက်များနှင့် အလုပ်လုပ်လိုပါက -
### Main Repository Setup
@ -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. **Repository ကို ဖော့ခ်လုပ်ပါ** သင် GitHub အကောင့သို့
2. **ဖော့ခ်လုပ်ထားသောကို ဒေါင်းလုပ်လုပ်ပါ** ဒေသရပ်ဆိုင်သောစက်၌
3. **သွားလိုသည့် ပြောင်းလဲမှုများအတွက် အသစ်သော ဘရောင်းချ်ဖန်တီးပါ**
4. သင်ခန်းစာအကြောင်းအရာ သို့မဟုတ်ကုဒ်ဥပမာများ ပြင်ဆင်ပါ
5. သက်ဆိုင်ရာပရောဂျက် ဖိုလ်ဒါများတွင် ကုဒ်ပြောင်းလဲမှုများ စမ်းသပ်ပါ
6. မိတ်ဆက်ချက်ညွှန်ကြားချက်များအတိုင်း pull request တင်ပြပါ
1. သင် GitHub အကောင့သို့ ရှယ်ယာစာကြည့်တိုက်ကို **fork** လုပ်ပါ
2. သင့် fork ကို ဒေသခံသို့ **clone** လုပ်ပါ
3. သင့်ပြောင်းလဲချက်များအတွက် **branch အသစ်တစ်ခုဖန်တီးပါ**
4. သင်ခန်းစာ အကြောင်းအရာများ သို့မဟုတ် ကုဒ်နမူနာများကို ပြင်ဆင်ပါ
5. လိုက်ဖက်သော ပရောဂျက် ဒါရိုက်ထရီများ၌ ကုဒ်ပြောင်းလဲမှုများကို စမ်းသပ်ပါ
6. ပုံမှန်လုပ်ငန်း စည်းမျဉ်းများကို လိုက်နာ၍ ပြင်ဆင်စေလိုသည့် pull request များ တင်ပါ
### For Learners
1. Repository ကို fork လုပ်ခြင်း သို့မဟုတ် clone လုပ်ခြင်း
2. သင်ခန်းစာ ဖိုလ်ဒါများ အဆက်အစပ်သွားပါ
3. နေရာတိုင်းတွင် README ဖိုင်များ ဖတ်ပါ
4. https://ff-quizzes.netlify.app/web/ တွင် သင်ခန်းစာမတိုင်မီ စစ်ဆေးမှု မေးခွန်းများ ဖြေဆိုပါ
5. သင်ခန်းစာဖိုလ်ဒါများရှိ ကုဒ်ဥပမာများခေါက်ထဲတွင် လေ့လာပါ
6. တာဝန်ယူချက်များနှင့် စိန်ကြိုးမှုများ ပြီးမြောက်ပါ
7. သင်ခန်းစာပြီးနောက် မေးခွန်းများ ဖြေဆိုပါ
1. ရှယ်ယာစာကြည့်တိုက်ကို fork သို့မဟုတ် clone လုပ်ပါ
2. သင်ခန်းစာ ဒါရိုက်ထရီများအတိုင်း ဆက်တိုက် သွားပါ
3. သင်ခန်းစာတိုင်း README ဖိုင်များ ဖတ်ပါ
4. https://ff-quizzes.netlify.app/web/ တွင် သင်ခန်းစာမတိုင်မီ Quiz များ ပြုလုပ်ပါ
5. သင်ခန်းစာဖိုဒါများ ပေါ်ရှိ ကုဒ်နမူနာများ ဖြတ်သန်း လေ့လာပါ
6. တာဝန်ယူမှုများနှင့် စိန်ခေါ်မှုများကို ပြီးမြောက်စေပါ
7. သင်ခန်းစာပြီးဆုံးပါက မြို့ခွဲ Quiz များဖြေဆိုပါ
### Live Development
- **မှတ်တမ်းကျော်**: အဓိကဖိုင်တွင် `docsify serve` ကို ဖွင့်ပါ (port 3000)
- **Quiz App**: quiz-app ဖိုလ်ဒါတွင် `npm run dev` ကို ဖွင့်ပါ
- **Projects**: HTML ပရောဂျက်များအတွက် VS Code Live Server extension ကို အသုံးပြုပါ
- **API Projects**: သက်ဆိုင်ရာ API ဖိုလ်ဒါများတွင် `npm start` ကို သုံးပါ
- **စာတမ်းများ**: root တွင် `docsify serve` command ဖြင့် စတင်ပါ (port 3000)
- **Quiz App**: quiz-app ဒါရိုက်ထရီတွင် `npm run dev` ကို ပြေးပါ
- **ပရောဂျက်များ**: HTML ပရောဂျက်များအတွက် VS Code Live Server extension အသုံးပြုပါ
- **API ပရောဂျက်များ**: သက်ဆိုင်ရာ API ဒါရိုက်ထရီများတွင် `npm start` သို့ ပြေးပါ
## Testing Instructions
@ -110,114 +110,114 @@ python api.py
```bash
cd quiz-app
npm run lint # ကုဒ်ပုံစံပြသနာများကိုစစ်ဆေးပါ
npm run build # တည်ဆောက်မှုအောင်မြင်မှုကိုအတည်ပြုပါ
npm run lint # ကုဒ်စတိုင်ပြဿနာများကိုစစ်ဆေးပါ
npm run build # ဆောက်လုပ်မှုအောင်မြင်မှုကိုအတည်ပြုပါ
```
### Bank API Testing
```bash
cd 7-bank-project/api
npm run lint # ကုဒ်ပုံစံပြဿနာများကို စစ်ဆေးပါ
node server.js # ဆာဗာသည် အမှားမပါဘဲ စတင်အောင် သေချာစစ်ဆေးပါ
npm run lint # ကုဒ်စတိုင်ပြဿနာများကိုစစ်ပါ
node server.js # စားမှတ်တင်စက်သည်အမှားမရှိဘဲစတင်နိုင်သည်ကိုအတည်ပြုပါ
```
### General Testing Approach
- ဤသည်မှာ အထူးသဖြင့် စနစ်တကျ အလိုအလျှောက် စမ်းသပ်မှု မပါသော ပညာရေးဖိုင်တိုက်ဖြစ်သည်
- လက်တွေ့ စမ်းသပ်မှုများ တွင် အောက်ပါအချက်များအပေါ် ဂရုပြုရမည်။
- ကုဒ်ဥပမာများ အမှားမရှိစွာ လုပ်ဆောင်နိုင်ခြင်း
- မှတ်တမ်းတွင် လင့်များလုံးဝ အလုပ်လုပ်နိုင်ခြင်း
- ပရောဂျက်များ ကို ထုတ်လုပ်မှု အောင်မြင်စွာ ပြီးဆုံးခြင်း
- ဥပမာများသည် စံချိန်စံညွှန်းနည်းလမ်းများအတိုင်းရှိခြင်း
- ဒါဟာ ပညာရေး ရှယ်ယာစာကြည့်တိုက်ဖြစ်ပြီး မလွန်စာစစ်ဆေးမှုများ မပါဝင်ပါ
- လက်တွေ့စမ်းသပ်မှုများအတွက် အာရုံစိုက်မှာက:
- ကုဒ်နမူနာများ အမှားမရှိ ဟောကောင်းစွာ လည်ပတ်ရမည်
- စာရွက်စာတမ်းများအတွင်းရှိ လင့်ခ်များမှန်ကန်ရမည်
- ပရောဂျက်များ အဆင်ပြေစွာ တည်ဆောက်နိုင်ရမည်
- နမူနာများသည် ကောင်းမွန်သော လက်တွေ့ အလေ့အထများနှင့် ကိုက်ညီရမည်
### Pre-submission Checks
- package.json ပါသော ဖိုလ်ဒါများတွင် `npm run lint` ဖြင့် စစ်ဆေးပါ
- markdown links များမှန်ကန်ကြောင်းစစ်ဆေးပါ
- ကုဒ်ဥပမာများကို browser သို့ Node.js တွင် စမ်းသပ်ပါ
- ဘာသာပြန်မှုများသည် စနစ်တကျရှိရေးကို စစ်ဆေးပါ
- package.json ပါဝင်သော ဒါရိုက်ထရီများတွင် `npm run lint` ကို လည်ပတ်ပါ
- markdown အတွင်းရှိလင့်ခ် များ သေချာစစ်ဆေးပါ
- ကုဒ်နမူနာများကို browser သို့ Node.js တွင် စမ်းသပ်ပါ
- ဘာသာပြန်ချက်များသည် ဖွဲ့စည်းမှုမှန်ကန်နေစေပါ
## Code Style Guidelines
### JavaScript
- အဆင့်မြင့် ES6+ စနစ်ကို အသုံးပြုပါ
- ပရောဂျက်များတွင် ထည့်သွင်းထားသည့် ကြိုးပမ်းမှု standard ESLint configurations တွေလိုက်နာပါ
- ပညာရေးအတွက် မှတ်သားပိုမိုချင်စိတ်ကို အဓိကထားသည့် အဓိပ္ပာယ်ကောင်းသော အမည်များသုံးပါ
- သင်ယူသူများအတွက်ပါ အကြောင်းအရာရှင်းပြချက် မက်ဆေ့ခ််များထည့်ပါ
- ရေးသားတပ်ဆင်ထားသော Prettier ဖြင့် ဖောမတ်လုပ်ခြင်း
- နောက်ဆုံးပေါ် ES6+ စံတော်ချိန်ကို အသုံးပြုပါ
- ပရောဂျက်များတွင် သတ်မှတ်ထားသော ESLint ဖိုင်များကိုလိုက်နာပါ
- ပညာရေးအတွက် နားလည်ရန်လွယ်ကူသော variable နဲ့ function နာမည်များကို အသုံးပြုပါ
- လေ့လာသူများအတွက် အကြောင်းအရာရှင်းလင်းရေးသားချက်များ ထည့်ပါ
- Prettier ဖြင့် ဖော်แม့တ် ပြုပြင်ထားသောနေရာများမှာ အသုံးပြုပါ
### HTML/CSS
- အဓိက အဓိပ္ပာယ်မြင့် HTML5 elements သုံးပါ
- တုံ့ပြန်မှုရှိသော ဒီဇိုင်နည်းများ
- သတ်မှတ်ထားသည့် class နာမည်ခေါင်းစဉ်များ ရှင်းလင်းစွာ သတ်မှတ်ခြင်း
- သင်ယူသူများအတွက် CSS နည်းလမ်းများ မှတ်ချက်ဖြင့် ရှင်းပြချက်ဖြည့်စွက်ခြင်း
- Semantic HTML5 အချက်အလက်များ
- တုံ့ပြန်နိုင်သော ဒီဇိုင်း နည်းလမ်းများ
- အသောက်လေးနာမည်များ ထည့်သွင်းရေးသားခြင်း
- CSS နည်းပညာများကို လေ့လာသူများအတွက် ရှင်းပြချက်များ ထည့်ပါ
### Python
- PEP 8 စတိုင်လမ်းညွှန်ချက်မျာ
- ရှင်းလင်းသောပညာရေးကုဒ်ဥပမာများ
- သင်ယူထောက်ပံ့မှုအတွက် type hints ထည့်ရန်
- PEP 8 စတိုင်နည်းလမ်းများလိုက်နာခြင်
- ပညာရေးအတွက် ရှင်းလင်းနှုတ်ဆိတ်သော ကုဒ်နမူနာများ
- သင်ယူမှုအတွက် အဆင်ပြေသော Type hint များ ထည့်သွင်းရေးသားခြင်း
### Markdown Documentation
- ဦးခေါင်းများ ပေါ်ပုံ ရှင်းလင်းစွာထားရှိခြင်း
- ဘာသာစကားသတ်မှတ်ချက်ပါသည့် ကုဒ်ဘလော့များ
- ထပ်ဆောင်းရင်းမြစ်များဆီ လင့်ခ်မျာ
- `images/` ဖိုလ်ဒါများရှိ နမူနာပုံများနှင့် စာရွက်ပုံများ
- အသုံးပြုနိုင်ရေးအတွက် ပုံများ၏ alt စာသားများ
- ခေါင်းစဉ်အဆင့်သတ်မှတ်မှု ရှင်းလင်းခြင်း
- ဘာသာပြန်ခြင်းနှင့် သတ်မှတ်အပ္ပလီကေးရှင်းများပါရှိသော code block များ
- အပိုဆောင်းရင်းမြစ်များသို့ လင့်ခ်ထည့်ခြင်
- `images/` ဖိုဒါများရှိ screenshot နှင့် ပုံများ
- ပုံများအတွက် အလတ်စာ (alt text) ထည့်သွင်းခြင်း Accessibility အတွက်
### File Organization
- သင်ခန်းစာများ အဆက်ဆက်အမှတ်စဉ်(၁-getting-started-lessons, ၂-js-basics စသည်ဖြင့်)
- ပရောဂျက်တိုင်းတွင် `solution/` နှင့် ပုံမှန်အားဖြင့် `start/` သို့မဟုတ် `your-work/` ဖိုလ်ဒါများ
- သင်ခန်းစာ သီးသန့် `images/` ဖိုလ်ဒါတွင် ပုံများထားရှိခြင်း
- ဘာသာပြန်ဖိုင်များကို `translations/{language-code}/` စနစ်ဖြင့် သိမ်းဆည်းခြင်း
- သင်ခန်းစာများကို နံပါတ်စဥ်လိုက် ကျသော ဖိုင်နာမည်များ (ဥပမာ 1-getting-started-lessons, 2-js-basics ကဲ့သို့)
- ပရောဂျက်တစ်ခုစီမှာ `solution/` နှင့် `start/` သို့မဟုတ် `your-work/` ဒါရိုက်ထရီများ မြောက်မြားစွာရှိသည်
- ပုံများကို သင်ခန်းစာအလိုက် `images/` ဖိုဒါထဲသိမ်းဆည်းထားသည်
- ဘာသာပြန်ဆိုချက်များကို `translations/{language-code}/` ဖိုဒါအတွင်းသိမ်းဆည်းထားသည်
## Build and Deployment
### Quiz App Deployment (Azure Static Web Apps)
quiz-app ကို Azure Static Web Apps တွင် တည်ဆောက်ထားသည် -
quiz-app ကို Azure Static Web Apps သို့ တင်ရန် သတ်မှတ်ထားသည်။
```bash
cd quiz-app
npm run build # dist/ ဖိုလ်ဒါကို ဖန်တီးသည်
# main branch သို့ push လုပ်သောအခါ GitHub Actions workflow ဖြင့် တင်သွင်းသည်
# main သို့ push လုပ်သောအခါ GitHub Actions workflow ဖြင့် တင်သွင်းသည်
```
Azure Static Web Apps configuration:
- **App location**: `/quiz-app`
- **Output location**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
Azure Static Web Apps သတ်မှတ်ချက်များ:
- **app location**: `/quiz-app`
- **output location**: `dist`
- **workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Documentation PDF Generation
```bash
npm install # docsify-to-pdf ကိုထည့်သွင်းပါ
npm run convert # docs မှ PDF ကိုထုတ်လုပ်ပါ
npm install # docsify-to-pdf ကို သွင်းပါ
npm run convert # docs မှ PDF ဖိုင်ထုတ်လုပ်ပါ
```
### Docsify Documentation
```bash
npm install -g docsify-cli # Docsify ကို ကမ္ဘာလုံးဆိုင်ရာ ထည့်သွင်းပါ
docsify serve # localhost:3000 ပေါ်တွင် ဆာဗ်ဖြစ်ပါစေ
npm install -g docsify-cli # Docsify ကို အနှံ့လတ်တလော တပ်ဆင်ပါ
docsify serve # localhost:3000 ပေါ်တွင် အဝန်ဆောင်မှု ပေးပါ
```
### Project-specific Builds
ပရောဂျက်တိုင်းသည် ကိုယ်ပိုင် ထုတ်လုပ်မှုလုပ်ငန်းစဉ်များရှိနိုင်သည် -
- Vue ပရောဂျက်များတွင် `npm run build` ဖြင့် ထုတ်လုပ်မှု bundle များပြုလုပ်သည်
- static ပရောဂျက်များတွင် build လုပ်မှု မရှိ၊ ဖိုင်များကို တိုက်ရိုက် ဝန်ဆောင်မှု ပေးသည်
ပရောဂျက်တစ်ခုစီတွင် သီးခြား build ပြုလုပ်မှုများ ရှိနိုင်သည်။
- Vue ပရောဂျက်များ: `npm run build` ဖြင့် production 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,57 +225,58 @@ docsify serve # localhost:3000 ပေါ်တွင် ဆာ
### Required Checks
PR တင်သည့်အခါမှာ -
PR တင်မည့်အခါ -
1. **ကုဒ်အရည်အသွေး**:
- သက်ဆိုင်ရာ project ဖိုလ်ဒါများတွင် `npm run lint` ပြေးပါ
- အမှားနှင့် သတိပေးချက်များအားလုံး ပြင်ဆင်ပါ
- သက်ဆိုင်ရာ ပရောဂျက် ဒါရိုက်ထရီများတွင် `npm run lint` အသုံးပြုပါ
- lint error များနှင့် သတိပေးချက်များအားလုံးကို ပြင်ဆင်ပါ
2. **ထုတ်လုပ်မှု ပြုလုပ်ခြင်း စစ်ဆေးမှု**:
- လိုက်လျောညီထွေရှိပါက `npm run build` ပြုလုပ်ပါ
- ရှာဖွေတွေ့ရှိသော အမှားမရှိကြောင်း သေချာစေပါ
2. **Build အတည်ပြုချက်**:
- လုပ်သင့်သည့်နေရာတွင် `npm run build` လည်ပတ်ပါ
- Build အမှားမရှိကြောင်းသေချာစေပါ
3. **လင့်ခ် စစ်တမ်း**:
- markdown သို့မဟုတ် ပုံဆိုင်ရာ လင့်ခ်များအားလုံး စစ်ဆေးပါ
3. **လင့်ခ်အတည်ပြုမှု**:
- Markdown အတွင်းရှိလင့်ခ်များအားလုံးစမ်းသပ်ပါ
- ပုံရုပ်လင့်ခ်များ လိုက်နာမှုစစ်ဆေးပါ
4. **အကြောင်းအရာ ပြန်လည်သုံးသပ်ခြင်း**:
- စာလုံးပေါင်းနှင့် စာကြောင်းမှားပေါ် မရှိစေပါနှင့်
- ကုဒ်ဥပမာများမှန်ကန်ပြီး ပညာရေးအတွက် ရည်ရွယ်ထားသည်မှန်ကန်စေရန်
- ဘာသာပြန်မှုများသည် မူရင်းအဓိပ္ပာယ်လိုက်ဖက်မှုရှိရေးကို စစ်ဆေးပါ
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 ရှင်းလင်းချက်တွင် issue နံပါတ်များ ထည့်သွင်းပါ
- [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 ကို အသုံးပြုသည်
- ၅၀ ကျော် ဘာသာစကားများအလိုအလျောက် ဘာသာပြန်သည်
- မူလဖိုင်များသည် main ဒါရိုက်ထရီများတွင် ရှိသည်
- ဘာသာပြန်ထားသော ဖိုင်များကို `translations/{language-code}/` တွင် သိမ်းဆည်းသည်
### Adding Manual Translation Improvements
1. `translations/{language-code}/` မှ ဖိုင်ကို ရှာဖွေပါ
2. ဖိုင် အပါအစိတ်အပိုင်းများကို မထိခိုက်ဘဲ တိုးတက်အောင် ပြင်ဆင်ပါ
3. ကုဒ်ဥပမာများသည် ဆက်လက် လည်ပတ်နိုင်ရေး အထောက်အကူဖြစ်စေရန် အာမခံပါ
4. အလိုက်သင့် ဘာသာပြန် သင်ခန်းစာ မေးခွန်းများကို စမ်းသပ်ပါ
1. `translations/{language-code}/` ဖိုင်ကို ရှာဖွေပါ
2. ဖွဲ့စည်းမှုမပျက်အောင် ကောင်းမွန်အောင် ပြင်ဆင်ပါ
3. ကုဒ်နမူနာများ လည်ပတ်မှု မကျဆင်းစေရန် သေချာစေပါ
4. ဒေသဆိုင်ရာ Quiz အကြောင်းအရာများကို စမ်းသပ်ပါ
### Translation Metadata
ဘာသာပြန်ဖိုင်များတွင် metadata header ပါဝင်သည် -
ဘာသာပြန်ထားသော ဖိုင်များတွင် metadata header ပါဝင်သည်
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -292,116 +293,116 @@ CO_OP_TRANSLATOR_METADATA:
### Common Issues
**Quiz app မဖြင့်တော့ခြင်း**:
- Node.js ဗားရှင်းစစ်ဆေးပါ (v14+ ကိုအကြံပြု)
- `node_modules` နှင့် `package-lock.json` ဖိုင်များ ဖျက်ပြီး `npm install` ထပ်တွဲဆောင်ရွက်ပါ
- ပေါ့(Port) ပဋိပက္ခ မရှိကြောင်း စစ်ဆေးပါ (Vite သည် ပုံမှန် 5173 ပေါ့သုံးသည်)
**Quiz app မစတင်နိုင်ခြင်း**:
- Node.js ဗားရှင်း (v14+ အကြံပြုသည်) စစ်ဆေးပါ
- `node_modules` နှင့် `package-lock.json` ဖိုင်များ ဖျက်ပစ်ပြီး `npm install` ပြန်လည် လုပ်ဆောင်ပါ
- port တွက်ဖက်မှု ရှိမရှိ စစ်ဆေးပါ (default ပါ Vite က port 5173 ကို အသုံးပြုသည်)
**API server မဖွင့်ခြင်း**:
- Node.js ဗားရှင်းဖြည့်စွက် ရှိပါစေ (node >=10)
- ပေါ့ (port)ကို အသုံးပြုနေမှု မရှိကြောင်း သေချာစေရန် စစ်ဆေးပါ
- လိုအပ်သည့် dependency များအားလုံး `npm install` ဖြင့် ထည့်သွင်းပြီးကြောင်း သေချာကာ
**API server မစတင်နိုင်ခြင်း**:
- Node.js ဗားရှင်းနည်းဆုံး (node >=10) ဖြည့်မြောက်သလား စစ်ဆေးပါ
- port တစ်ခုစီ မတူညီသေးခဲ့မရှိ စစ်ဆေးပါ
- မလိုအပ်စွာ ဘာသာရေးမရှိပါက `npm install` ဖြင့် မပါဝင်သေးသော dependency များ ထည့်သွင်းပါ
**Browser extension မတင်နိုင်ခြင်း**:
- manifest.json format မှန်ကန်မှု
- browser console မှာ အမှားမရှိကြောင်း စစ်ဆေးပါ
- browser-specific extension တပ်ဆင်မှုအညွှန်းများ လိုက်နာပါ
- manifest.json ဖိုင်၏ ဖော်ပြချက်မှန်ကန်မှု စစ်ဆေးပါ
- browser console တွင် error များ ရှိမရှိ စစ်ပါ
- browser များအလိုက် extension တပ်ဆင်မှု လမ်းညွှန်ချက်များ လိုက်နာပါ
**Python chat project ပြဿနာ**:
- OpenAI package တပ်ဆင်ထားမှု `pip install openai`
- GITHUB_TOKEN environment variable သတ်မှတ်ထားမှု
- GitHub Models အတွက် လက်မှတ်ခွင့်များရှိမှုစစ်ဆေးပါ
**Python chat project ပြဿနာများ**:
- OpenAI package ထည့်သွင်းထားခြင်း (pip install openai)
- GITHUB_TOKEN ပြင်ပ ဆက်တင် variable သတ်မှတ်ထားခြင်း
- GitHub Models သို့ ဝင်ရောက်ခွင့်ရှိခြင်း စစ်ဆေးပါ
**Docsify မှတ်တမ်းမဖွင့်ခြင်း**:
- `docsify-cli` ကို ပိုင်းလောဂျီအားဖြင့် တပ်ဆင်ပါ - `npm install -g docsify-cli`
- Repository အမြစ် ဒါရိုက်တာထိုင်မှ ပေါ်တင်ပါ
- `docs/_sidebar.md` ရှိကြောင်းစစ်ဆေးပါ
**Docsify စာရွက်စာတမ်း မပေးဆောင်နိုင်ခြင်း**:
- docsify-cli ကို အားလုံး အသုံးပြုနိုင်အောင် `npm install -g docsify-cli` ဖြင့် ထည့်သွင်းပါ
- ရှယ်ယာစာကြည့်တိုက် root မှာ ပြေးပါ
- `docs/_sidebar.md` ဖိုင် ရှိမှု စစ်ဆေးပါ
### Development Environment Tips
- HTML ပရောဂျက်များအတွက် VS Code Live Server extension အသုံးပြုပါ
- ESLint နှင့် Prettier extension များတပ်ဆင်ပြီး ဖောင်မက်ကို စနစ်တကျ ထိန်းသိမ်းပါ
- JavaScript debugging အတွက် browser DevTools အသုံးပြုပါ
- Vue ပရောဂျက်များအတွက် Vue DevTools browser extension တပ်ဆင်ပါ
- ESLint နှင့် Prettier extension များ ထည့်သွင်းထား၍ အညီအညွတ် ဖြစ်အောင် ပြုလုပ်ပါ
- JavaScript debugging အတွက် browser DevTools ကို အသုံးပြုပါ
- Vue ပရောဂျက်များအတွက် Vue DevTools browser extension ထည့်သွင်းပါ
### Performance Considerations
- ဘာသာပြန်ဖိုင်များ (၅၀+ ဘာသာစကား) အရေတွက်ကြီးကြောင်းကြောင့် clone အကြီးအကျယ် ဖြစ်နိုင်သည်
- content သာ အလုပ်လုပ်မည်ဆိုပါက shallow clone အသုံးပြုပါ - `git clone --depth 1`
- အင်္ဂလိပ်ဘာသာများတွင် ဘာသာပြန်မှုများကို ရှာဖွေမှုမှ အနုတ်ထုတ်ပါ
- ပထမဆုံး run တွင် build process အနည်းငယ်နှေးကွေးနိုင်သည် (npm install, Vite build)
- ဘာသာပြန်စာပေါင်းများစွာ ဖြစ်ပြီး (၅၀+ ဘာသာစကား) clone လုပ်ရာတွင် အရေအတွက်ကြီးသည်
- content ဖန်တီးခြင်းသာလုပ်လျင် shallow clone (`git clone --depth 1`) ကို အသုံးပြုပါ
- English အကြောင်းအရာလုပ်နေစဉ် အခြားဘာသာပြန်ဖိုင်များကို ရှာဖွေရွေးချယ်မှုမှ ဖယ်ရှားပါ
- build လုပ်ငန်းများ ပထမဆုံး run မှာ အချို့ အချိန်ယူနိုင်သည် (npm install, Vite build)
## Security Considerations
### Environment Variables
- API ကီးများကို Repository တွင် commit မပြုလုပ်သင့်ပါ
- `.env` ဖိုင်များကို အသုံးပြုပါ (သည်နောက် `.gitignore` တွင် ပါဝင်သည်)
- လိုအပ်သည့် environment variable များကို project README များတွင် ဖော်ပြပါ
- API ကီးများကို ရှယ်ယာစာကြည့်တိုက်ထဲ မတင်သင့်ပါ
- `.env` ဖိုင်များကို အသုံးပြုပါ (ဒေတာအပိုင်း `.gitignore` ထဲမှာပါ)
- သက်ဆိုင်ရာ ပရောဂျက် README များနဲ့ တိုက်ရိုက်ဖော်ပြပါ
### Python Projects
- virtual environment သုံးပါ - `python -m venv venv`
- dependencies များကို သက်တမ်းမကုန်ရှင်းစွာ သိမ်းဆည်းပါ
- GitHub tokens များသည် လိုအပ်ဆုံးအမြင့်ဆုံး ခွင့်ပြုချက်သာ ပေးပါ
- virtual environment များ (`python -m venv venv`) အသုံးပြုပါ
- dependency များကို နေထိုင်အောင် ကြီးမားစွာ Update တင်ပါ
- GitHub token များကို လိုအပ်သလို Permissions သတ်မှတ် ပါရမည်
### GitHub Models Access
- Personal Access Tokens (PATs) မရှိမဖြစ်လိုအပ်ပါသည်
- tokens များကို environment variables အဖြစ် သိမ်းဆည်းရမည်
- tokens သို့မဟုတ် လျှို့ဝှက်ချက် မလုပ်ထုတ်သင့်ပါ
- GitHub Models သုံးရန် Personal Access Tokens (PAT) လိုအပ်သည်
- Tokens များကို environment variables အနေနဲ့ ထိန်းသိမ်းပါ
- Token များ သို့မဟုတ် credential များကို သည်ရှယ်ယာစာကြည့်တိုက်တွင် အပ်โหลดမလုပ်ပါနှင့်
## Additional Notes
### Target Audience
- web development စတင်သင်ယူမှု လူသစ်များ
- ကျောင်းသားများနှင့် ကိုယ်တိုင် သင်ယူသူများ
- သင်ရိုးညွှန်းတမ်းကို စာသင်ခန်းများတွင် အသုံးပြုသော ဆရာမများ
- အားလုံးအတွက် ဝင်ရောက် ချ Easy လွယ်အောင် ထားရှိခြင်းနှင့် အဆင့်ဆင့် ကျွမ်းကျင်မှု တိုးတက်စေခြင်း
- ဝဘ်ဖွံ့ဖြိုးတိုးတက်မှု စတင်သူ အပြည့်အဝ
- ကျောင်းသားများနှင့် ကိုယ်တိုင်လေ့လာသူများ
- သင်ကြားရေးတွင် သင်ရိုးညွှန်းအသုံးပြုသော ဆရာ/ဆရာမများ
- ပရောဂျက်ကို လက်လှမ်းမှီရသော အသုံးပြုခွင့် ရှိမှုနှင့် အတက်အကျမှာ ဦးစားပေးထားသည်
### Educational Philosophy
- ပရောဂျက်အခြေပြု သင်ကြားမှုနည်းလမ်း
- Knowledge checks (quizzes) များအားသက်တမ်းမတိုအောင် ကြာလတီစွာ ခြေရာခံခြင်း
- လက်တွေ့ ကုဒ်ရေးစမ်းသပ်ခြင်
- အမှန်တကယ် အသုံးချနိုင်သော နမူနာများ
- framework မတိုင်မီ အခြေခံအမြင်ကို အထူးပြုခြင်း
- ပရောဂျက်အခြေပြု သင်ယူမှု လမ်းဆုံ
- မကြာခဏ သိမှတ်မှု စစ်တမ်းများ (quizzes)
- လက်တွေ့ ကုဒ်ရေးသားမှု လေ့ကျင့်ခန်းမျာ
- လောကီအသုံးချမှု နမူနာများ
- framework မသုံးမီ အခြေခံများအား အလေးထားမှု
### Repository Maintenance
- သင်ယူသူများနှင့် အထောက်အပံ့ပေးသူများ အဖွဲ့အစည်း စတက်ရောက်နေသည်
- dependencies နှင့် အကြောင်းအရာများ ပုံမှန် ပြင်ဆင် ပြောင်းလဲမှုများလုပ်သည်
- issue များနှင့် ဆွေးနွေးမှုများ စောင့်ကြည့်သူများရှိသည်
- ဘာသာပြန်မှု update များကို GitHub Actions ဖြင့် အလိုအလျောက်လုပ်ဆောင်သည်
- တက်ကြွသော သင်ယူသူများ နှင့် ပါဝင်သူများ အသိုင်းအဝိုင်း
- လက်ရှိ dependencies နဲ့ အကြောင်းအရာများ ကို ပုံမှန်သက်ဆိုင်မှု ပြုလုပ်ခြင်း
- ပြဿနာများ နှင့် ဆွေးနွေးမှုများ ကို မန်နေဂျာများက စောင့်ကြည့်မှုရှိမှု
- ဘာသာပြန်ချက်များကို 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
အသေးစိတ် ညွှန်ကြားချက်များအတွက် အောက်ပါ 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 အပေါ်အခြေခံထားသောဂိမ်းဖန်တီးမှု
ပရောဂျက်တစ်ခုချင်းစီအတွက် အသေးစိတ်ညွှန်ကြားချက်များကို အောက်ပါ README ဖိုင်များတွင် ကြည့်ရှုနိုင်သည်။
- `quiz-app/README.md` - Vue 3 ကို သုံး၍ quiz application
- `7-bank-project/README.md` - authentication ပါဝင်သည့် ဘဏ်ဆိုင်ရာ အက်ပ်
- `5-browser-extension/README.md` - browser extension ဖန်တီးခြင်း
- `6-space-game/README.md` - canvas အခြေပြု ဂိမ်း ဖန်တီးခြင်း
- `9-chat-project/README.md` - AI chat assistant ပရောဂျက်
### Monorepo Structure
ရိုးရာ monorepo မဟုတ်သော်လည်း ဖိုင်တိုက်တွင် ပရောဂျက်များ မျိုးစုံ ပါသည် -
- သင်ခန်းစာတိုင်းမှာ ကိုယ်ပိုင် လွတ်လပ်မှုရှိသည်
- ပရောဂျက်များသည် အချင်းချင်း အသုံးပြုသော dependencies များ မမျှမျှဝေပါ
- သီးသန့်ပရောဂျက်အား လုပ်ကိုင်ပြီး အခြားပရောဂျက်များအပေါ် သက်ရောက်မှုမရှိစေရန်
- အပြည့်အစုံ သင်ရိုးရှိမှုအတွက် အားလုံးကို clone လုပ်ပါ
ဤ ရှယ်ယာစာကြည့်တိုက်သည် လူသိများသော ပုံမှန် monorepo မဟုတ်ပေမယ့် သီးခြားပရောဂျက်များ အများကြီး ပါဝင်သည်။
- သင်ခန်းစာတိုင်းသည် အလိုအလျောက် သီးသန့်ဖြစ်သည်
- အစိတ်အပိုင်းများသည် dependency မမျှဝေကြ
- အစိတ်အပိုင်းတစ်ခုရဲ့ အလုပ်လုပ်မှုသည် အခြားအစိတ်အပိုင်းများအား ထိခိုက်မှုမရှိစေ
- အပြည့်အစုံ သင်ရိုးအသုံးပြုရန် ရှယ်ယာစာကြည့်တိုက် ပြည့်နှက်စွာ 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-06T12:02:33+00:00",
"translation_date": "2026-02-06T13:24:21+00:00",
"source_file": "AGENTS.md",
"language_code": "sl"
},

@ -2,27 +2,27 @@
## Pregled projekta
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.
To je repozitorij izobraževalnega kurikuluma za učenje osnov spletnega razvoja za začetnike. Kurikulum je celovit 12-tedenski tečaj, ki ga je razvila skupina Microsoft Cloud Advocates in vsebuje 24 praktičnih lekcij o JavaScriptu, CSS-u in HTML-u.
### Ključne komponente
### Ključne Komponente
- **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
- **Izobraževalna vsebina**: 24 strukturiranih lekcij organiziranih v projektno usmerjene module
- **Praktični projekti**: Terrarium, Igra tipkanja, Razširitev brskalnika, Igra v vesolju, Bančni app, Urejevalnik kode in AI klepetalni pomočnik
- **Interaktivni kvizi**: 48 kvizov s po 3 vprašanji (pred/po lekciji)
- **Večjezična podpora**: avtomatski 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ž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 preko GitHub Actions (co-op-translator)
- Dokumentacija na voljo preko Docsify in kot PDF
- Izobraževalni repozitorij z organizacijo po lekcijah
- Vsaka mapa lekcije vsebuje README, primere kode in rešitve
- Samostojni projekti v ločenih imenikih (quiz-app, različni projekti lekcij)
- Sistem za prevode z uporabo GitHub Actions (co-op-translator)
- Dokumentacija gostovana preko Docsify in na voljo tudi kot PDF
## Ukazi za nastavitev
Ta repozitorij je namenjen predvsem za uporabo izobraževalne vsebine. Za delo z določenimi projekti:
Ta repozitorij je namenjen predvsem za porabo izobraževalne vsebine. Za delo s specifičnimi projekti:
### Nastavitev glavnega repozitorija
@ -36,17 +36,17 @@ cd Web-Dev-For-Beginners
```bash
cd quiz-app
npm install
npm run dev # Začni razvojni strežnik
npm run build # Zgradi za produkcijo
npm run dev # Zaženi razvojni strežnik
npm run build # Izgradi za produkcijo
npm run lint # Zaženi ESLint
```
### Bančni API projekt (Node.js + Express)
### Bančni projekt API (Node.js + Express)
```bash
cd 7-bank-project/api
npm install
npm start # Zaženi API strežnik
npm start # Začni API strežnik
npm run lint # Zaženi ESLint
npm run format # Oblikuj s Prettierjem
```
@ -56,10 +56,10 @@ npm run format # Oblikuj s Prettierjem
```bash
cd 5-browser-extension/solution
npm install
# Sledite navodilom za nalaganje razširitev, specifičnih za brskalnik
# Sledite navodilom za nalaganje razširitev, značilnih za brskalnik
```
### Projekti igre vesolja
### Projekti igre v vesolju
```bash
cd 6-space-game/solution
@ -67,42 +67,42 @@ npm install
# Odprite index.html v brskalniku ali uporabite Live Server
```
### Klepetalni projekt (Python backend)
### Klepetalni projekt (Python Backend)
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# Nastavi okoljsko spremenljivko GITHUB_TOKEN
# Nastavite okoljsko spremenljivko GITHUB_TOKEN
python api.py
```
## Razvojni potek
## Razvojni potek dela
### Za prispevatele vsebine
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
1. **Forkajte repozitorij** v svoj GitHub račun
2. **Klonirajte svoj fork** lokalno
3. **Ustvarite novo vejo** za svoje spremembe
4. Naredite spremembe lekcijske vsebine ali primerov kode
5. Testirajte spremembe kode v ustreznih projektnih mapah
6. Oddajte pull requeste v skladu s pravili prispevkov
### Za učence
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
1. Forkajte ali klonirajte repozitorij
2. Postopoma pregledujte mape lekcij
3. Berite README datoteke za vsako lekcijo
4. Opravite pred-lesson kvize na https://ff-quizzes.netlify.app/web/
5. Preizkusite primere kode v mapah lekcij
6. Izpolnite naloge in izzive
7. Opravite post-lesson kvize
### Živ razvoj
- **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
- **Dokumentacija**: Zaženite `docsify serve` v korenski mapi (port 3000)
- **Quiz App**: Zaženite `npm run dev` v mapi quiz-app
- **Projekti**: Uporabite VS Code Live Server extension za HTML projekte
- **API projekti**: Zaženite `npm start` v ustreznih API mapah
## Navodila za testiranje
@ -110,82 +110,82 @@ python api.py
```bash
cd quiz-app
npm run lint # Preveri težave s slogom kode
npm run build # Preveri, ali je izdelava uspešna
npm run lint # Preverite težave s slogom kode
npm run build # Potrdite uspešnost gradnje
```
### Testiranje Bank API
```bash
cd 7-bank-project/api
npm run lint # Preveri morebitne težave s slogom kode
node server.js # Preveri, ali se strežnik zažene brez napak
npm run lint # Preveri težave s slogom kode
node server.js # Preveri, ali strežnik zažene brez napak
```
### Splošen pristop k testiranju
- Gre za izobraževalni repozitorij brez celovitih avtomatiziranih testov
- Ročno testiranje fokusira na:
- Kode primere delujejo brez napak
- To je izobraževalni repozitorij brez obsežnih avtomatiziranih testov
- Ročno testiranje se osredotoča na:
- Primeri kode naj se izvajajo brez napak
- Povezave v dokumentaciji delujejo pravilno
- Projekti se uspešno zgradijo
- Projekti naj se uspešno zgradijo
- Primeri sledijo najboljšim praksam
### Kontrole pred oddajo
### Preverjanje pred oddajo
- 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
- Zaženite `npm run lint` v mapah z package.json
- Preverite veljavnost markdown povezav
- Testirajte primere kode v brskalniku ali Node.js
- Preverite, da prevodi ohranjajo pravilno strukturo
## Smernice za slog kode
## Smernice za stil kode
### JavaScript
- 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
- Uporabljajte sodobno ES6+ sintakso
- Sledite standardnim ESLint nastavitvam, ki so v projektih
- Uporabljajte smiselne imena spremenljivk in funkcij za jasnost izobraževanja
- Dodajte komentarje, ki pojasnjujejo koncepte za učence
- Oblikujte kodo s Prettier tam, kjer je konfiguriran
### HTML/CSS
- Semantični HTML5 elementi
- Principi odzivnega dizajna
- Jasne konvencije imenovanja razredov
- Principi odzivnega oblikovanja
- Jasne konvencije za poimenovanje razredov
- Komentarji, ki razlagajo CSS tehnike za učence
### Python
- Smernice sloga PEP 8
- Jasni, izobraževalni kode primeri
- Tipni namigi tam, kjer so uporabni za učenje
- Smernice stila PEP 8
- Jasni, izobraževalni primeri kode
- Tipični namigi, kjer so koristni za učenje
### Markdown dokumentacija
- Jasna hierarhija naslovov
- Bloki kode z določanjem jezika
- Bloki kode z določenim jezikom
- Povezave do dodatnih virov
- Posnetki zaslona in slike v mapah `images/`
- Alt besedilo za slike za dostopnost
- Posnetki zaslona in slike v `images/` mapah
- Alt besedilo za slike zaradi dostopnosti
### Organizacija datotek
- Lekcije oštevilčene zaporedno (1-getting-started-lessons, 2-js-basics, itd.)
- Lekcije oštevilčene zaporedno (1-getting-started-lessons, 2-js-basics itd.)
- 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
- Prevedene različice v `translations/{language-code}/` strukturi
## Gradnja in implementacija
## Gradnja in uvajanje
### Implementacija Quiz App (Azure Static Web Apps)
### Uvajanje Quiz App (Azure Static Web Apps)
Quiz-app je konfiguriran za implementacijo Azure Static Web Apps:
Quiz-app je konfiguriran za uvajanje v Azure Static Web Apps:
```bash
cd quiz-app
npm run build # Ustvari mapo dist/
# Izvede namestitev preko GitHub Actions delovnega toka ob pushu na main
# Izvede namestitev prek GitHub Actions poteka ob pushanju na main
```
Konfiguracija Azure Static Web Apps:
@ -197,7 +197,7 @@ Konfiguracija Azure Static Web Apps:
```bash
npm install # Namestite docsify-to-pdf
npm run convert # Ustvarite PDF iz docs
npm run convert # Ustvari PDF iz dokumentacije
```
### Dokumentacija Docsify
@ -207,76 +207,76 @@ npm install -g docsify-cli # Namestite Docsify globalno
docsify serve # Postrežite na localhost:3000
```
### Gradnje specifične za projekt
### Specifični projekti - gradnje
Vsaka projektna mapa ima lahko svoj build proces:
Vsaka projektna mapa lahko ima svoj postopek gradnje:
- Vue projekti: `npm run build` ustvari produkcijske pakete
- Statični projekti: brez gradnje, datoteke streže neposredno
- Statični projekti: brez gradbenega koraka, datoteke so služene neposredno
## Pravila za pull requeste
### Format naslova
### Oblika naslova
Uporabi jasne, opisne naslove, ki označujejo področje spremembe:
Uporabljajte jasne, opisne naslove, ki označujejo področje spremembe:
- `[Quiz-app] Dodaj nov kviz za lekcijo X`
- `[Lesson-3] Popravi tipkarsko napako v projektu terrarium`
- `[Lesson-3] Popravi tipkarsko napako v terrarium projektu`
- `[Translation] Dodaj španski prevod za lekcijo 5`
- `[Docs] Posodobi navodila za namestitev`
- `[Docs] Posodobi navodila za nastavitev`
### Obvezne kontrole
Pred pošiljanjem PR:
Pred oddajo PR:
1. **Kakovost kode**:
- Zaženi `npm run lint` v prizadetih projektnem mapah
- Odpravi vse napake in opozorila
- Zaženite `npm run lint` v prizadetih projektnih mapah
- Odpravite vse napake in opozorila
2. **Preverjanje gradnje**:
- Zaženi `npm run build`, če je potrebno
- Poskrbi, da ni napak pri gradnji
- Zaženite `npm run build`, če velja
- Zagotovite, da ni napak pri gradnji
3. **Preverjanje povezav**:
- Preizkusi vse markdown povezave
- Potrdi, da reference slik delujejo
- Testirajte vse markdown povezave
- Preverite, da slike delujejo
4. **Pregled vsebine**:
- Preveri črkovanje in slovnico
- Zagotovi pravilnost in poučnost kode primerov
- Preveri, da prevodi ohranjajo prvotni pomen
- Preverite pravopis in slovnico
- Zagotovite pravilnost in izobraževalno vrednost primerov kode
- Preverite, da prevodi ohranjajo pomen
### Zahteve za prispevek
### Zahteve za prispevanje
- 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
- Strinjajte se z Microsoft CLA (avtomatski pregled ob prvem PR)
- Sledite [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Preberite [CONTRIBUTING.md](./CONTRIBUTING.md) za podrobne smernice
- Navedite številke vprašanj v opisu PR, če je potrebno
### Proces pregleda
- 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
- PR-e pregledajo vzdrževalci in skupnost
- Prednost ima jasnost izobraževanja
- Primeri kode naj sledijo najboljšim aktualnim praksam
- Prevodi se pregledajo zaradi natančnosti in kulturne ustreznosti
## Sistem prevajanja
### Avtomatiziran prevod
### Avtomatski prevod
- Uporablja GitHub Actions s co-op-translator delovnim tokom
- Samodejno prevaja v več kot 50 jezikov
- Izvorne datoteke v glavnih mapah
- Prevede v več kot 50 jezikov samodejno
- Izvorne datoteke v glavnih imenikih
- Prevedene datoteke v `translations/{language-code}/` mapah
### Dodajanje ročnih izboljšav prevoda
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
1. Poiščite datoteko v `translations/{language-code}/`
2. Naredite izboljšave ob ohranitvi strukture
3. Poskrbite, da primeri kode ostanejo funkcionalni
4. Testirajte lokalizirano vsebino kvizov
### Metapodatki prevoda
Prevedene datoteke vključujejo meta podatkovni glavi:
Prevedene datoteke vključujejo metapodatkovno glavo:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
-->
```
## Odpravljanje napak in reševanje težav
## Odpravljanje napak in težav
### Pogoste težave
**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)
**Quiz app ne začne delovati**:
- Preverite različico Node.js (priporočeno v14+)
- Izbrišite `node_modules` in `package-lock.json`, nato ponovno zaženite `npm install`
- Preverite konflikte vrat (privzeto: Vite uporablja vrata 5173)
**API strežnik se ne zažene**:
- 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`
- Preverite, da je Node.js verzija vsaj 10
- Preverite, ali vrata že niso zasedena
- Prepričajte se, da so vse odvisnosti nameščene z `npm install`
**Razširitev brskalnika se ne naloži**:
- Preveri, ali je manifest.json pravilno oblikovan
- Preveri konzolo brskalnika za napake
- Sledi navodilom za namestitev razširitve za določen brskalnik
- Preverite pravilno oblikovanje manifest.json
- Preverite konzolo brskalnika za napake
- Sledite navodilom za namestitev specifičnim za brskalnik
**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
- Preverite, da je nameščena knjižnica OpenAI: `pip install openai`
- Preverite, da je okoljska spremenljivka GITHUB_TOKEN nastavljena
- Preverite dovoljenja za dostop do GitHub Models
**Docsify ne streže dokumentacije**:
- Namesti docsify-cli globalno: `npm install -g docsify-cli`
- Zaženi iz korenskega imenika repozitorija
- Preveri, da obstaja `docs/_sidebar.md`
- Namestite docsify-cli globalno: `npm install -g docsify-cli`
- Zaženite iz korenske mape repozitorija
- Preverite, da obstaja `docs/_sidebar.md`
### Nasveti za razvojno okolje
- 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
- Uporabljajte VS Code z Live Server razširitvijo za HTML projekte
- Namestite ESLint in Prettier razširitve za enotno oblikovanje
- Uporabljajte brskalniška orodja za odpravljanje napak v JavaScriptu
- Za Vue projekte namestite Vue DevTools razširitev za brskalnik
### Razmišljanja o zmogljivosti
### Razmisleki o zmogljivosti
- 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)
- Veliko število prevedenih datotek (več kot 50 jezikov) pomeni, da so kloni veliki
- Uporabite plitek klon, če delate samo na vsebini: `git clone --depth 1`
- Izključite prevode iz iskanja, če delate na angleški vsebini
- Gradbeni postopki so lahko počasni ob prvem zagonu (npm install, Vite build)
## Varnostni vidiki
### Okoljske spremenljivke
- 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
- API ključi se nikoli ne smejo oddajati v repozitorij
- Uporabljajte `.env` datoteke (že vključeno v `.gitignore`)
- Dokumentirajte potrebne okoljske spremenljivke v README-ih posameznih projektov
### Python projekti
- Uporabljaj virtualna okolja: `python -m venv venv`
- Ohrani odvisnosti posodobljene
- GitHub žetoni naj imajo minimalne potrebne pravice
- Uporabljajte virtualna okolja: `python -m venv venv`
- Ohranjajte odvisnosti posodobljene
- GitHub žetoni naj imajo minimalna potrebna dovoljenja
### Dostop do GitHub modelov
### Dostop do GitHub Modelov
- Osebni dostopni žetoni (PAT) so potrebni za GitHub modele
- Žetoni naj bodo shranjeni kot okoljske spremenljivke
- Nikoli ne nastavljaj žetonov ali poverilnic v repozitorij
- Potrebni so osebni dostopni žetoni (PAT) za GitHub Models
- Žetone shranjujte kot okoljske spremenljivke
- Žetoni ali poverilnice nikoli ne smejo biti oddani
## Dodatne opombe
### Ciljna publika
- Popolni začetniki v spletni razvoj
- Študentje in samouki
- Učitelji, ki uporabljajo kurikulum v razredih
- Vsebina je zasnovana za dostopnost in postopno pridobivanje veščin
- Študenti in samouki
- Učitelji, ki uporabljajo kurikulum v razredu
- Vsebina je zasnovana za dostopnost in postopno nadgrajevanje znanja
### Izobraževalna filozofija
- Pristop učenja preko projektov
- Pogoste preveritve znanja (kvizi)
- Praktične vaje s kodiranjem
- Resnični primeri uporabe
- Osredotočanje na osnove pred okvirji
- Projektno usmerjen pristop k učenju
- Pogoste kontrole znanja (kvizi)
- Praktične vaje s kodo
- Primeri uporabe iz resničnega sveta
- Osredotočenost na osnove pred okviri
### Vzdrževanje repozitorija
- Aktivna skupnost učencev in prispevkov
- Aktivna skupnost učencev in prispevateľev
- Redne posodobitve odvisnosti in vsebine
- Spremljanje težav in razprav s strani vzdrževalcev
- Avtomatizirane posodobitve prevodov preko GitHub Actions
- Spremljanje vprašanj in razprav s strani vzdrževalcev
- Samodejne posodobitve prevodov preko GitHub Actions
### Sorodni viri
- [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
- [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: Generativni AI, Podatkovna znanost, ML, IoT kurikulumi na voljo
### Delo z določenimi projekti
### Delo s specifičnimi projekti
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
Za podrobna navodila o posameznih projektih glejte README datoteke:
- `quiz-app/README.md` - Vue 3 aplikacija kviza
- `7-bank-project/README.md` - Bančna aplikacija z autentikacijo
- `5-browser-extension/README.md` - Razvoj razširitve brskalnika
- `6-space-game/README.md` - Razvoj igre na platnu (canvas)
- `9-chat-project/README.md` - AI klepetalni asistent
- `9-chat-project/README.md` - Projekt AI klepetalnega pomočnika
### Struktura monorepoja
### Struktura Monorepo
Čeprav ni tradicionalni monorepo, ta repozitorij vsebuje več samostojnih projektov:
Čeprav ni tipični monorepo, ta repozitorij vsebuje več neodvisnih projektov:
- Vsaka lekcija je samostojna
- Projekti ne uporabljajo skupnih odvisnosti
- Projekti ne delijo odvisnosti
- Delo na posameznih projektih brez vpliva na druge
- Nakloni celoten repozitorij za popolno izkušnjo kurikuluma
- Klonirajte celoten repozitorij za celotno 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 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.
**Opozorilo**:
Ta dokument je bil preveden z uporabo AI prevajalske storitve [Co-op Translator](https://github.com/Azure/co-op-translator). Kljub prizadevanjem za natančnost vas prosimo, da upoštevate, da avtomatizirani prevodi lahko vsebujejo napake ali netočnosti. Izvirni dokument v njegovem izvirnem jeziku naj velja za avtoritativni vir. Za ključne informacije priporočamo strokovni človeški prevod. Za morebitna nesporazume ali napačne interpretacije, ki izhajajo iz uporabe tega prevoda, ne prevzemamo nobene odgovornosti.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->
Loading…
Cancel
Save