diff --git a/translations/hr/.co-op-translator.json b/translations/hr/.co-op-translator.json index 8fba09fc4..d0db79c74 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-06T12:01:18+00:00", + "translation_date": "2026-02-06T13:23:07+00:00", "source_file": "AGENTS.md", "language_code": "hr" }, diff --git a/translations/hr/AGENTS.md b/translations/hr/AGENTS.md index f66576fd2..8b06f6c9f 100644 --- a/translations/hr/AGENTS.md +++ b/translations/hr/AGENTS.md @@ -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 **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. \ No newline at end of file diff --git a/translations/my/.co-op-translator.json b/translations/my/.co-op-translator.json index 209338bff..ae4ce0ade 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-06T12:04:02+00:00", + "translation_date": "2026-02-06T13:25:56+00:00", "source_file": "AGENTS.md", "language_code": "my" }, diff --git a/translations/my/AGENTS.md b/translations/my/AGENTS.md index c7e8382f2..825693287 100644 --- a/translations/my/AGENTS.md +++ b/translations/my/AGENTS.md @@ -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 -**အသိပေးချက်** -ဤစာတမ်းကို 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 de3ccb805..6a92f3185 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-06T12:02:33+00:00", + "translation_date": "2026-02-06T13:24:21+00:00", "source_file": "AGENTS.md", "language_code": "sl" }, diff --git a/translations/sl/AGENTS.md b/translations/sl/AGENTS.md index 687a97177..755bcd897 100644 --- a/translations/sl/AGENTS.md +++ b/translations/sl/AGENTS.md @@ -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 ``` -## 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 --- -**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. \ No newline at end of file