diff --git a/translations/hr/.co-op-translator.json b/translations/hr/.co-op-translator.json index 7acd25fe1..8fba09fc4 100644 --- a/translations/hr/.co-op-translator.json +++ b/translations/hr/.co-op-translator.json @@ -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" }, diff --git a/translations/hr/AGENTS.md b/translations/hr/AGENTS.md index d511219aa..f66576fd2 100644 --- a/translations/hr/AGENTS.md +++ b/translations/hr/AGENTS.md @@ -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 **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. \ No newline at end of file diff --git a/translations/my/.co-op-translator.json b/translations/my/.co-op-translator.json index ddc7e1b86..209338bff 100644 --- a/translations/my/.co-op-translator.json +++ b/translations/my/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T10:15:57+00:00", + "translation_date": "2026-02-06T12:04:02+00:00", "source_file": "AGENTS.md", "language_code": "my" }, diff --git a/translations/my/AGENTS.md b/translations/my/AGENTS.md index a68101492..c7e8382f2 100644 --- a/translations/my/AGENTS.md +++ b/translations/my/AGENTS.md @@ -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 -**တားမြစ်ချက်** -ဤစာတမ်းကို AI ဘာသာပြန်ဝန်ဆောင်မှုဖြစ်သည့် [Co-op Translator](https://github.com/Azure/co-op-translator) အသုံးပြု၍ ဘာသာပြန်ထားခြင်းဖြစ်ပါသည်။ ကျွန်ုပ်တို့သည်တိကျမှန်ကန်မှုအတွက်ကြိုးစားသည်ဖြစ်သော်လည်း၊ စက်စွမ်းအားဘာသာပြန်ဆိုမှုများတွင် အမှားအယွင်းများ၊ မမှန်ကန်မှုများ ရှိနိုင်သည်ကို အသိပေးပါရစေ။ မူလစာတမ်းသည် မိခင်ဘာသာစကားဖြင့် ရေးသားထားသည့် ညွှန်ကြားချက်အရင်းအမြစ်အဖြစ် စဉ်းစားရမည်ဖြစ်ပါသည်။ အရေးကြီးသော အချက်အလက်များအတွက် လူ့ကျွမ်းကျင်သူများမှ ဘာသာပြန်ခြင်းကို အကြံပြုပါသည်။ ဤဘာသာပြန်ချက်ကို အသုံးပြုမှုကြောင့် ဖြစ်ပေါ်လာနိုင်သော နားမလည်မှုများ သို့မဟုတ် အမှားဖော်ပြချက်များအတွက် ကျွန်ုပ်တို့သည် တာဝန်မခံယူပါ။ +**အသိပေးချက်** +ဤစာတမ်းကို AI ဘာသာပြန်ဝန်ဆောင်မှု [Co-op Translator](https://github.com/Azure/co-op-translator) ဖြင့် ဘာသာပြန်ထားပါသည်။ ကျွန်ုပ်တို့သည် တိကျမှုအတွက် ကြိုးစားသည်မှာ မှန်ပေမယ့် အလိုအလျောက် ဘာသာပြန်မှုများတွင် အမှားများ သို့မဟုတ် မှန်ကန်မှု တစ်ချို့ မရှိနိုင်ပါကြောင်း သတိပြုပါရန် မေတ္တာရပ်ခံအပ်ပါသည်။ မူရင်းစာတမ်းကို တိုင်းပြည်ဘာသာဖြင့်သာ ယုံကြည်စိတ်ချရသော အထောက်အထားအဖြစ် စဉ်းစားသင့်ပါသည်။ အရေးပါသော သတင်းအချက်အလက်များအတွက် လူ့ဘာသာပြန်သူပညာရှင်များ၏ ဘာသာပြန်မှုကို သုံးစွဲရန် အကြံပြုပါသည်။ ဤဘာသာပြန်ချက်အသုံးပြုမှုကြောင့်ဖြစ်ပေါ်နိုင်သည့် နားလည်မှုမှားခြင်းများ သို့မဟုတ် မှားယွင်းသောသဘောထားများအတွက် ကျွန်ုပ်တို့ မည်သည့် တာဝန်မှ မယူဆောင်ပါ။ \ No newline at end of file diff --git a/translations/sl/.co-op-translator.json b/translations/sl/.co-op-translator.json index adccb89c5..de3ccb805 100644 --- a/translations/sl/.co-op-translator.json +++ b/translations/sl/.co-op-translator.json @@ -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" }, diff --git a/translations/sl/AGENTS.md b/translations/sl/AGENTS.md index e371a5ade..687a97177 100644 --- a/translations/sl/AGENTS.md +++ b/translations/sl/AGENTS.md @@ -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 ``` -## 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 --- -**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. \ No newline at end of file