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

pull/1793/head
localizeflow[bot] 5 months ago
parent 575ee30487
commit b82e39c5ad

@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T17:00:55+00:00", "translation_date": "2026-04-20T16:22:13+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "hr" "language_code": "hr"
}, },

@ -2,27 +2,27 @@
## Pregled projekta ## Pregled projekta
Ovo je edukacijski repozitorij za podučavanje osnova web razvoja početnicima. Kurikulum je sveobuhvatan tečaj od 12 tjedana koji su razvili Microsoft Cloud zagovornici, sa 24 praktične lekcije koje pokrivaju JavaScript, CSS i HTML. Ovo je repozitorij nastavnog programa za podučavanje osnova web razvoja početnicima. Nastavni plan i program 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.
### Ključne komponente ### Ključne komponente
- **Edukativni sadržaj**: 24 strukturirane lekcije organizirane u module temeljene na projektima - **Nastavni sadržaj**: 24 strukturirane lekcije organizirane u module temeljene na projektima
- **Praktični projekti**: Terrarium, igra tipkanja, ekstenzija za preglednik, svemirska igra, banka aplikacija, uređivač koda i AI chat asistent - **Praktični projekti**: Terrarij, Igra tipkanja, Proširenje za preglednik, Svemirska igra, Bankarska aplikacija, Code Editor i AI Chat asistent
- **Interaktivni kvizovi**: 48 kvizova sa po 3 pitanja (evaluacije prije i poslije lekcija) - **Interaktivni kvizovi**: 48 kvizova sa po 3 pitanja svaki (procjena prije i nakon lekcije)
- **Podrška za više jezika**: Automatizirani prijevodi za 50+ jezika putem GitHub Actions - **Višestruka podrška jezika**: Automatski prijevodi na 50+ jezika putem GitHub Actions
- **Tehnologije**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (za AI projekte) - **Tehnologije**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (za AI projekte)
### Arhitektura ### Arhitektura
- Edukacijski repozitorij s lekcijskom strukturom - Edukativni repozitorij sa strukturom baziranom na lekcijama
- Svaka mapa lekcije sadrži README, primjere koda i rješenja - Svaka mapa lekcije sadrži README, primjere koda i rješenja
- Samostalni projekti u zasebnim direktorijima (quiz-app, razni projekti lekcija) - Samostalni projekti u posebnim direktorijima (quiz-app, razni projektni lekcijski direktoriji)
- Sustav prijevoda koristeći GitHub Actions (co-op-translator) - Sustav prevođenja pomoću GitHub Actions (co-op-translator)
- Dokumentacija dostupna preko Docsify i kao PDF - Dokumentacija poslužena putem Docsify i dostupna kao PDF
## Komande za postavljanje ## Komande za postavljanje
Ovaj repozitorij je prvenstveno za konzumaciju edukativnog sadržaja. Za rad s pojedinim projektima: Ovaj repozitorij je primarno namijenjen za konzumaciju edukativnog sadržaja. Za rad s određenim projektima:
### Postavljanje glavnog repozitorija ### Postavljanje glavnog repozitorija
@ -41,22 +41,22 @@ npm run build # Izgradi za produkciju
npm run lint # Pokreni ESLint npm run lint # Pokreni ESLint
``` ```
### Bankovni projekt API (Node.js + Express) ### Bankarski projekt API (Node.js + Express)
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm install npm install
npm start # Pokreni API server npm start # Pokreni API poslužitelj
npm run lint # Pokreni ESLint npm run lint # Pokreni ESLint
npm run format # Formatiraj s Prettierom npm run format # Formatiraj s Prettierom
``` ```
### Projekti ekstenzija za preglednik ### Projekti proširenja za preglednik
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
npm install npm install
# Slijedite upute za učitavanje proširenja specifične za preglednik # Slijedite upute za učitavanje ekstenzija specifičnih za preglednik
``` ```
### Projekti svemirske igre ### Projekti svemirske igre
@ -72,35 +72,35 @@ npm install
```bash ```bash
cd 9-chat-project/solution/backend/python cd 9-chat-project/solution/backend/python
pip install openai pip install openai
# Postavi GITHUB_TOKEN varijablu okoline # Postavi varijablu okoline GITHUB_TOKEN
python api.py python api.py
``` ```
## Radni tijek razvoja ## Razvojni tijek rada
### Za suradnike na sadržaju ### Za suradnike na sadržaju
1. **Forkajte repozitorij** na svoj GitHub račun 1. **Forkajte repozitorij** na svoj GitHub račun
2. **Klonirajte svoj fork** lokalno 2. **Klonirajte svoj fork** lokalno
3. **Napravite novu granu** za svoje promjene 3. **Napravite novu granu** za svoje promjene
4. Izmijenite sadržaj lekcija ili primjere koda 4. Izvršite promjene u sadržaju lekcija ili primjerima koda
5. Testirajte promjene koda u relevantnim direktorijima projekata 5. Testirajte sve izmjene koda u odgovarajućim projektnim direktorijima
6. Pošaljite pull requestove prateći smjernice za doprinos 6. Pošaljite pull requestove u skladu s uputama za doprinose
### Za učenike ### Za učenike
1. Forkajte ili klonirajte repozitorij 1. Forkajte ili klonirajte repozitorij
2. Redom prolazite kroz direktorije lekcija 2. Navigirajte kroz direktorije lekcija redom
3. Čitajte README datoteke za svaku lekciju 3. Čitajte README datoteke za svaku lekciju
4. Riješite pred-lezijske kvizove na https://ff-quizzes.netlify.app/web/ 4. Završite kvizove prije lekcija na https://ff-quizzes.netlify.app/web/
5. Prođite primjere koda u mapama lekcija 5. Riješite primjere koda u mapama lekcija
6. Ispratite zadatke i izazove 6. Završite zadatke i izazove
7. Odgovorite na post-lezijske kvizove 7. Polažite kvizove nakon lekcija
### Aktivni razvoj ### Živi razvoj
- **Dokumentacija**: Pokrenite `docsify serve` u korijenu (port 3000) - **Dokumentacija**: Pokrenite `docsify serve` u rootu (port 3000)
- **Quiz App**: Pokrenite `npm run dev` u direktoriju quiz-app - **Quiz aplikacija**: Pokrenite `npm run dev` u direktoriju quiz-app
- **Projekti**: Koristite VS Code Live Server ekstenziju za HTML projekte - **Projekti**: Koristite VS Code Live Server ekstenziju za HTML projekte
- **API projekti**: Pokrenite `npm start` u odgovarajućim API direktorijima - **API projekti**: Pokrenite `npm start` u odgovarajućim API direktorijima
@ -110,87 +110,87 @@ python api.py
```bash ```bash
cd quiz-app cd quiz-app
npm run lint # Provjerite ima li problema sa stilom koda npm run lint # Provjeri probleme sa stilom koda
npm run build # Provjerite je li izgradnja uspješna npm run build # Provjeri uspješnost izgradnje
``` ```
### Testiranje Bank API-ja ### Testiranje Bank API-ja
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm run lint # Provjerite probleme sa stilom koda npm run lint # Provjeri probleme sa stilom koda
node server.js # Provjerite pokreće li se server bez pogrešaka node server.js # Provjeri da li se poslužitelj pokreće bez grešaka
``` ```
### Opći pristup testiranju ### Opći pristup testiranju
- Ovo je edukacijski repozitorij bez sveobuhvatnih automatiziranih testova - Ovo je edukativni repozitorij bez sveobuhvatnih automatskih testova
- Ručno testiranje fokusira se na: - Ručno testiranje fokusira se na:
- Primjere koda koji se izvršavaju bez grešaka - Primjere koda koji se izvršavaju bez pogrešaka
- Ispravnost linkova u dokumentaciji - Ispravno funkcioniranje linkova u dokumentaciji
- Uspješno dovršen build projekata - Uspješnu gradnju projekata
- Primjere u skladu s najboljim praksama - Slijedjenje najboljih praksi u primjerima
### Provjere prije slanja ### Provjere prije slanja
- Pokrenite `npm run lint` u direktorijima s package.json - Pokrenite `npm run lint` u direktorijima s package.json
- Provjerite valjanost markdown linkova - Provjerite valjanost markdown linkova
- Testirajte primjere koda u pregledniku ili Node.js - Testirajte primjere koda u pregledniku ili Node.js
- Provjerite da prijevodi održavaju ispravnu strukturu - Provjerite da prijevodi održavaju pravilnu strukturu
## Smjernice za stil koda ## Smjernice za stil kodiranja
### JavaScript ### JavaScript
- Koristite modernu ES6+ sintaksu - Koristite modernu ES6+ sintaksu
- Pridržavajte se standardnih ESLint konfiguracija u projektima - Slijedite standardne ESLint konfiguracije iz projekata
- Koristite značenjem bogate nazive varijabli i funkcija za edukativnu jasnoću - Koristite smisleno imenovanje varijabli i funkcija radi jasnoće za učenike
- Dodajte komentare koji objašnjavaju koncepte za učenike - Dodajte komentare koji objašnjavaju koncepte
- Formatirajte kod pomoću Prettiera gdje je konfigurirano - Formatirajte kod koristeći Prettier gdje je konfigurirano
### HTML/CSS ### HTML/CSS
- Semantički HTML5 elementi - Semantički HTML5 elementi
- Principi responzivnog dizajna - Principi responzivnog dizajna
- Jasan sustav imenovanja klasa - Jasne konvencije imenovanja klasa
- Komentari koji pojašnjavaju CSS tehnike za učenike - Komentari koji objašnjavaju CSS tehnike za učenike
### Python ### Python
- Slijedite PEP 8 stil - Pridržavajte se PEP 8 smjernica
- Jasni, edukativni primjeri koda - Jasni, edukativni primjeri koda
- Tipizacija gdje pomaže za učenje - Tipizacije tamo gdje pomažu učenju
### Markdown dokumentacija ### Markdown dokumentacija
- Jasna hijerarhija naslova - Jasna hijerarhija naslova
- Blokovi koda s označenim jezikom - Code blokovi s označenim jezikom
- Linkovi na dodatne resurse - Linkovi na dodatne resurse
- Screenshoti i slike u mapama `images/` - Screenshoti i slike u mapama `images/`
- Alt tekst za slike radi pristupačnosti - Alt tekst za slike radi pristupačnosti
### Organizacija datoteka ### Organizacija datoteka
- Lekcije numerirane uzlazno (1-getting-started-lessons, 2-js-basics itd.) - Lekcije numerirane sekvencijalno (1-getting-started-lessons, 2-js-basics, itd.)
- Svaki projekt sadrži `solution/` i često `start/` ili `your-work/` mape - Svaki projekt ima direktorije `solution/` i često `start/` ili `your-work/`
- Slike pohranjene u mapama `images/` specifičnim za lekciju - Slike se nalaze u lekcijski specifičnim mapama `images/`
- Prijevodi u strukturi `translations/{language-code}/` - Prijevodi u strukturi `translations/{language-code}/`
## Izgradnja i implementacija ## Gradnja i implementacija
### Implementacija Quiz aplikacije (Azure Static Web Apps) ### Postavljanje Quiz aplikacije (Azure Static Web Apps)
Quiz-app je konfigurirana za implementaciju na Azure Static Web Apps: Quiz aplikacija je konfigurirana za implementaciju na Azure Static Web Apps:
```bash ```bash
cd quiz-app cd quiz-app
npm run build # Stvara mapu dist/ npm run build # Stvara mapu dist/
# Raspoređuje putem GitHub Actions workflow-a prilikom push-a na main # Implementira putem GitHub Actions workflow-a pri pushanju na main
``` ```
Konfiguracija Azure Static Web Apps: Konfiguracija Azure Static Web Apps:
- **Lokacija aplikacije**: `/quiz-app` - **Lokacija aplikacije**: `/quiz-app`
- **Izlazna mapa**: `dist` - **Lokacija izlaza**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Generiranje PDF dokumentacije ### Generiranje PDF dokumentacije
@ -200,26 +200,26 @@ npm install # Instalirajte docsify-to-pdf
npm run convert # Generirajte PDF iz docsa npm run convert # Generirajte PDF iz docsa
``` ```
### Docsify dokumentacija ### Dokumentacija Docsify
```bash ```bash
npm install -g docsify-cli # Globalno instalirajte Docsify npm install -g docsify-cli # Instalirajte Docsify globalno
docsify serve # Poslužite na localhost:3000 docsify serve # Poslužite na localhost:3000
``` ```
### Svojstvene gradnje projekata ### Gradnje specifične za projekte
Svaki projekt može imati svoj proces izgradnje: Svaki projektni direktorij može imati vlastiti proces gradnje:
- Vue projekti: `npm run build` kreira produkcijske bundle - Vue projekti: `npm run build` kreira produkcijske bundleove
- Statički projekti: Nema izgradnje, datoteke se serviraju direktno - Statički projekti: bez koraka gradnje, direktna usluga datoteka
## Smjernice za pull request ## Smjernice za pull requestove
### Format naslova ### Format naslova
Koristite jasne, opisne naslove koji označavaju područje promjene: Koristite jasne, opisne naslove koji označavaju područje promjene:
- `[Quiz-app] Dodaj novi kviz za lekciju X` - `[Quiz-app] Dodaj novi kviz za lekciju X`
- `[Lesson-3] Ispravi tipfeler u terrarium projektu` - `[Lesson-3] Ispravi tipfelere u terrarium projektu`
- `[Translation] Dodaj španjolski prijevod za lekciju 5` - `[Translation] Dodaj španjolski prijevod za lekciju 5`
- `[Docs] Ažuriraj upute za postavljanje` - `[Docs] Ažuriraj upute za postavljanje`
@ -228,55 +228,55 @@ Koristite jasne, opisne naslove koji označavaju područje promjene:
Prije slanja PR-a: Prije slanja PR-a:
1. **Kvaliteta koda**: 1. **Kvaliteta koda**:
- Pokrenite `npm run lint` u pogođenim direktorijima projekata - Pokrenite `npm run lint` u pogođenim projektnim direktorijima
- Ispravite sve linting greške i upozorenja - Ispravite sve lint greške i upozorenja
2. **Provjera builda**: 2. **Verifikacija gradnje**:
- Pokrenite `npm run build` ako je primjenjivo - Pokrenite `npm run build` ako je primjenjivo
- Provjerite da nema grešaka u buildu - Osigurajte da nema grešaka u gradnji
3. **Validacija linkova**: 3. **Provjera linkova**:
- Testirajte sve markdown linkove - Testirajte sve markdown linkove
- Provjerite ispravnost referenci na slike - Provjerite ispravnost referenci na slike
4. **Pregled sadržaja**: 4. **Pregled sadržaja**:
- Le Korrekture pravopisa i gramatike - Provjerite pravopis i gramatiku
- Osigurajte da su primjeri koda točni i edukativni - Osigurajte da su primjeri koda točni i edukativni
- Provjerite da prijevodi točno prenose značenje - Provjerite da prijevodi čuvaju izvorno značenje
### Zahtjevi za doprinos ### Zahtjevi za doprinos
- Prihvatite Microsoft CLA (automatska provjera kod prvog PR-a) - Prihvatite Microsoft CLA (automatska provjera pri prvom PR-u)
- Pridržavajte se [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) - Slijedite [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Pogledajte [CONTRIBUTING.md](./CONTRIBUTING.md) za detaljne smjernice - Pogledajte [CONTRIBUTING.md](./CONTRIBUTING.md) za detaljne upute
- Uključite brojeve problema u opis PR-a ako je primjenjivo - U opisu PR-a navedite brojeve povezanih issuea ako ih ima
### Proces pregleda ### Proces pregleda
- PR-ove pregledavaju održavatelji i zajednica - PR-ove pregledavaju održavatelji i zajednica
- Prioritet je edukativna jasnoća - Prioritet je jasnoća edukativnog sadržaja
- Primjeri koda trebaju slijediti aktualne najbolje prakse - Primjeri koda trebaju slijediti trenutne najbolje prakse
- Prijevodi se pregledavaju zbog točnosti i kulturne prikladnosti - Prijevodi se pregledavaju radi točnosti i kulturne prikladnosti
## Sustav prijevoda ## Sustav prevođenja
### Automatski prijevod ### Automatizirani prijevod
- Koristi GitHub Actions s co-op-translator workflowom - Koristi GitHub Actions s co-op-translator workflowom
- Automatski prevodi na 50+ jezika - Automatski prevodi na 50+ jezika
- Izvorne datoteke u glavnim direktorijima - Izvorne datoteke u glavnim direktorijima
- Prevedene datoteke u `translations/{language-code}/` direktorijima - Prevedene datoteke u direktorijima `translations/{language-code}/`
### Dodavanje ručnih poboljšanja prijevoda ### Dodavanje ručnih poboljšanja prijevoda
1. Pronađite datoteku u `translations/{language-code}/` 1. Pronađite datoteku u `translations/{language-code}/`
2. Izvršite poboljšanja uz očuvanje strukture 2. Napravite poboljšanja pazeći na očuvanje strukture
3. Provjerite da primjeri koda ostaju funkcionalni 3. Osigurajte ispravnost funkcionalnosti primjera koda
4. Testirajte lokalizirani sadržaj kvizova 4. Testirajte eventualni lokalizirani sadržaj kvizova
### Metapodaci prijevoda ### Metapodaci prijevoda
Prevedene datoteke sadrže zaglavlje metapodataka: Prevedene datoteke sadrže metapodatkovni header:
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
--> -->
``` ```
## Debugiranje i rješavanje problema ## Otklanjanje pogrešaka i rješavanje problema
### Česti problemi ### Česti problemi
**Quiz aplikacija se ne pokreće**: **Quiz aplikacija ne želi startati**:
- Provjerite verziju Node.js (preporuka v14+) - Provjerite verziju Node.js (preporučeno v14+)
- Obrišite `node_modules` i `package-lock.json`, pokrenite ponovno `npm install` - Izbrišite `node_modules` i `package-lock.json`, pokrenite `npm install` ponovno
- Provjerite konflikte portova (zadano: Vite koristi port 5173) - Provjerite sukobe portova (default: Vite koristi port 5173)
**API server se ne pokreće**: **API server se ne pokreće**:
- Provjerite minimalnu verziju Node.js (node >=10) - Provjerite zadovoljava li Node.js minimalnu verziju (node >=10)
- Provjerite je li port zauzet - Provjerite je li port zauzet
- Osigurajte da su sve ovisnosti instalirane s `npm install` - Osigurajte da su sve ovisnosti instalirane s `npm install`
**Ekstenzija preglednika se ne učitava**: **Proširenje za preglednik se ne učitava**:
- Provjerite je li manifest.json ispravno formatiran - Provjerite ispravnost manifest.json formata
- Provjerite konzolu preglednika za greške - Provjerite konzolu preglednika za greške
- Slijedite upute za instalaciju ekstenzija za konkretan preglednik - Slijedite upute za instalaciju proširenja specifične za preglednik
**Problemi s chat projektom u Pythonu**: **Problemi s Python chat projektom**:
- Osigurajte da je paket OpenAI instaliran: `pip install openai` - Provjerite je li instaliran paket OpenAI: `pip install openai`
- Provjerite je li postavljena varijabla okoline GITHUB_TOKEN - Provjerite je li GITHUB_TOKEN varijabla okruženja postavljena
- Provjerite dozvole pristupa GitHub Models - Provjerite dozvole pristupa za GitHub Models
**Docsify ne prikazuje dokumente**: **Docsify ne poslužuje dokumente**:
- Instalirajte docsify-cli globalno: `npm install -g docsify-cli` - Instalirajte docsify-cli globalno: `npm install -g docsify-cli`
- Pokrenite iz korijena repozitorija - Pokrenite iz root direktorija repozitorija
- Provjerite postoji li `docs/_sidebar.md` - Provjerite postoji li `docs/_sidebar.md`
### Savjeti za razvojno okruženje ### Savjeti za razvojno okruženje
- Koristite VS Code s Live Server ekstenzijom za HTML projekte - Koristite VS Code s Live Server ekstenzijom za HTML projekte
- Instalirajte ESLint i Prettier ekstenzije za dosljedno formatiranje - Instalirajte ESLint i Prettier ekstenzije za dosljedno formatiranje
- Koristite DevTools preglednika za debugiranje JavaScript-a - Koristite DevTools u pregledniku za debug JavaScripta
- Za Vue projekte instalirajte Vue DevTools ekstenziju preglednika - Za Vue projekte instalirajte Vue DevTools ekstenziju za preglednik
### Performanse ### Razmatranja performansi
- Velik broj prevedenih datoteka (50+ jezika) znači da su puni klonovi veliki - Veliki broj prevedenih datoteka (50+ jezika) uzrokuje velike klonove
- Koristite shallow clone ako radite samo na sadržaju: `git clone --depth 1` - Koristite shallow clone ako radite samo na sadržaju: `git clone --depth 1`
- Izuzmite prijevode iz pretraživanja prilikom rada na engleskom sadržaju - Isključite prijevode iz pretraživanja kad radite na sadržaju na engleskom
- Procesi buildanja mogu biti spori pri prvom pokretanju (npm install, Vite build) - Procesi gradnje mogu biti spori pri prvom pokretanju (npm install, Vite build)
## Sigurnosne napomene ## Sigurnosna razmatranja
### Varijable okoline ### Varijable okruženja
- API ključevi se nikada ne smiju komitirati u repozitorij - API ključevi se nikad ne bi smjeli komitirati u repozitorij
- Koristite `.env` datoteke (već u `.gitignore`) - Koristite `.env` datoteke (već navedene u `.gitignore`)
- Dokumentirajte potrebne varijable okoline u README-ima projekata - Dokumentirajte potrebne varijable okruženja u README-ima projekata
### Python projekti ### Python projekti
- Koristite virtualna okruženja: `python -m venv venv` - Koristite virtualna okruženja: `python -m venv venv`
- Održavajte ovisnosti ažurirane - Održavajte ovisnosti ažurnima
- GitHub tokeni trebaju imati minimalne potrebne dozvole - GitHub tokeni trebaju imati minimalne potrebne dozvole
### Pristup GitHub Models ### Pristup GitHub Models
- Za GitHub Models potrebni su Personal Access Tokeni (PAT) - Potrebni su Personal Access Tokens (PAT) za GitHub modele
- Tokeni se trebaju pohraniti kao varijable okoline - Tokeni trebaju biti pohranjeni kao varijable okruženja
- Nikad ne komitirajte tokene ili pristupne podatke - Nikad nemojte komitirati tokene ili vjerodajnice
## Dodatne napomene ## Dodatne napomene
### Ciljana publika ### Ciljana publika
- Potpuni početnici u web razvoju - Potpuni početnici u web razvoju
- Studenti i samouki učenici - Studenti i samostalni učenici
- Nastavnici koji koriste kurikulum u učionicama - Nastavnici koji koriste nastavne planove u učionicama
- Sadržaj je dizajniran za pristupačnost i postupno izgrađivanje vještina - Sadržaj je osmišljen za pristupačnost i postupno stjecanje vještina
### Edukativna filozofija ### Pedagoška filozofija
- Projektno učenje - Pristup učenja baziran na projektima
- Česte provjere znanja (kvizovi) - Česte provjere znanja (kvizovi)
- Praktične vježbe kodiranja - Praktične vježbe kodiranja
- Primjeri primjene u stvarnom svijetu - Primjeri iz stvarnog svijeta
- Fokus na osnovama prije frameworka - Fokus na temelje prije okvira
### Održavanje repozitorija ### Održavanje repozitorija
- Aktivna zajednica učenika i suradnika - Aktivna zajednica učenika i suradnika
- Redovna ažuriranja ovisnosti i sadržaja - Redovne nadogradnje ovisnosti i sadržaja
- Problemi i diskusije nadzirani od strane održavatelja - Problemi i diskusije praćeni od strane održavatelja
- Ažuriranja prijevoda automatizirana putem GitHub Actions - Automatska ažuriranja prijevoda putem GitHub Actions
### Povezani resursi ### Povezani resursi
- [Microsoft Learn moduli](https://docs.microsoft.com/learn/) - [Microsoft Learn moduli](https://docs.microsoft.com/learn/)
- [Student Hub resursi](https://docs.microsoft.com/learn/student-hub/) - [Student Hub resursi](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) preporučen za učenike - Preporučen GitHub Copilot za učenike: [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot)
- Dodatni tečajevi: Generative AI, Data Science, ML, IoT kurikulumi dostupni - Dodatni tečajevi: Generativni AI, Data Science, ML, IoT kurikulumi dostupni
### Rad s pojedinim projektima ### Rad s određenim projektima
Za detaljne upute o pojedinačnim projektima, pogledajte README datoteke u: Za detaljne upute o pojedinačnim projektima, pogledajte README datoteke u:
- `quiz-app/README.md` - Vue 3 aplikacija kviza - `quiz-app/README.md` - Vue 3 aplikacija kviza
- `7-bank-project/README.md` - Bankovna aplikacija s autentikacijom - `7-bank-project/README.md` - Bankarska aplikacija s autentikacijom
- `5-browser-extension/README.md` - Razvoj ekstenzije za preglednik - `5-browser-extension/README.md` - Razvoj proširenja za preglednik
- `6-space-game/README.md` - Razvoj igre koristeći Canvas - `6-space-game/README.md` - Razvoj igre bazirane na canvasu
- `9-chat-project/README.md` - AI chat asistent projekt - `9-chat-project/README.md` - Projekt AI chat asistenta
### Struktura monorepa ### Struktura Monorepo repozitorija
Iako nije tradicionalni monorepo, ovaj repozitorij sadrži više neovisnih projekata: Iako nije tradicionalni monorepo, repozitorij sadrži više nezavisnih projekata:
- Svaka lekcija je samostalna - Svaka lekcija je samostalna
- Projekti ne dijele ovisnosti - Projekti ne dijele ovisnosti
- Radite na pojedinim projektima bez utjecaja na druge - Rad na pojedinačnim projektima bez utjecaja na druge
- Klonirajte cijeli repozitorij za kompletno iskustvo kurikuluma - Klonirajte cijeli repozitorij za potpuno iskustvo nastavnog programa
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Odricanje od odgovornosti**: **Odricanje od odgovornosti**:
Ovaj dokument preveden je koristeći AI servis za prevođenje [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 izvornom jeziku smatra se autoritativnim izvorom. Za kritične informacije preporučuje se profesionalni ljudski prijevod. Ne snosimo odgovornost za bilo kakva nesporazuma ili pogrešne interpretacije koje proizlaze iz uporabe ovog prijevoda. Ovaj dokument je preveden pomoću AI usluge za prijevod [Co-op Translator](https://github.com/Azure/co-op-translator). Iako težimo točnosti, molimo 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 važne informacije preporučuje se profesionalni ljudski prijevod. Ne snosimo odgovornost za bilo kakve nesporazume ili kriva tumačenja koja proizlaze iz korištenja ovog prijevoda.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T17:02:14+00:00", "translation_date": "2026-04-20T16:23:49+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "sl" "language_code": "sl"
}, },

@ -2,29 +2,29 @@
## Pregled projekta ## Pregled projekta
To je repozitorij izobraževalnega kurikuluma za poučevanje osnov spletnega razvoja začetnikom. Kurikulum je obsežen 12-tedenski tečaj, ki ga je razvila skupina Microsoft Cloud Advocates, in vsebuje 24 praktičnih lekcij o JavaScriptu, CSS-ju in HTML-ju. To je učni učni načrt za poučevanje osnov spletnega razvoja za začetnike. Učni načrt je obsežen 12-tedenski tečaj, ki so ga razvili Microsoft Cloud Advocates, in vsebuje 24 praktičnih lekcij o JavaScriptu, CSS in HTML.
### Ključne komponente ### Ključne sestavine
- **Izobraževalna vsebina**: 24 strukturiranih lekcij, organiziranih v projektno usmerjene module - **Izobraževalna vsebina**: 24 strukturiranih lekcij, organiziranih v modulih na osnovi projektov
- **Praktični projekti**: Terrarij, igra tipkanja, razširitev brskalnika, vesoljska igra, bančna aplikacija, urejevalnik kode in AI klepetalni asistent - **Praktični projekti**: Terarij, Tipkovniška igra, Razširitev brskalnika, Vesoljska igra, Bančna aplikacija, Urejevalnik kode in AI klepetalni pomočnik
- **Interaktivni kvizi**: 48 kvizov s po 3 vprašanji (pred in po lekciji) - **Interaktivni kvizi**: 48 kvizov s 3 vprašanji vsak (pred in po lekciji)
- **Večjezična podpora**: Samodejni prevodi v več kot 50 jezikov preko GitHub Actions - **Podpora za več jezikov**: 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) - **Tehnologije**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (za AI projekte)
### Arhitektura ### Arhitektura
- Izobraževalni repozitorij z strukturo, osnovano na lekcijah - Učni skladišče z strukturo na osnovi lekcij
- Vsaka mapa lekcije vsebuje datoteko README, primerke kode in rešitve - Vsaka mapa lekcije vsebuje README, primere kode in rešitve
- Samostojni projekti v ločenih imenikih (quiz-app, različni projektni lekcije) - Samostojni projekti v ločenih imenikih (quiz-app, različni lekcijski projekti)
- Sistem prevajanja z GitHub Actions (co-op-translator) - Sistem za prevajanje z uporabo GitHub Actions (co-op-translator)
- Dokumentacija postrežena preko Docsify in na voljo kot PDF - Dokumentacija, postrežena preko Docsify in dostopna kot PDF
## Ukazi za nastavitev ## Ukazi za nastavitev
Ta repozitorij je namenjen predvsem za uživanje izobraževalne vsebine. Za delo z določenimi projekti: To skladišče je primarno namenjeno za uživanje izobraževalne vsebine. Za delo z določenimi projekti:
### Nastavitev glavnega repozitorija ### Nastavitev glavnega skladišča
```bash ```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
@ -37,11 +37,11 @@ cd Web-Dev-For-Beginners
cd quiz-app cd quiz-app
npm install npm install
npm run dev # Zaženi razvojni strežnik npm run dev # Zaženi razvojni strežnik
npm run build # Sestavi za produkcijo npm run build # Zgradi za produkcijo
npm run lint # Zaženi ESLint npm run lint # Zaženi ESLint
``` ```
### Banka Projekt API (Node.js + Express) ### API projekta Banka (Node.js + Express)
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
@ -51,12 +51,12 @@ npm run lint # Zaženi ESLint
npm run format # Oblikuj s Prettierjem npm run format # Oblikuj s Prettierjem
``` ```
### Projekti za razširitev brskalnika ### Projekti razširitev brskalnika
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
npm install npm install
# Sledite navodilom za nalaganje razširitev, specifičnim za brskalnik # Upoštevajte navodila za nalaganje razširitev, specifična za brskalnik
``` ```
### Projekti vesoljske igre ### Projekti vesoljske igre
@ -67,7 +67,7 @@ npm install
# Odprite index.html v brskalniku ali uporabite Live Server # Odprite index.html v brskalniku ali uporabite Live Server
``` ```
### Projekt Klepet (Python Backend) ### Projekt klepeta (Python Backend)
```bash ```bash
cd 9-chat-project/solution/backend/python cd 9-chat-project/solution/backend/python
@ -76,33 +76,33 @@ pip install openai
python api.py python api.py
``` ```
## Razvojni potek ## Razvojni potek dela
### Za prispevke k vsebini ### Za prispevatele vsebine
1. **Forkajte repozitorij** na svoj GitHub račun 1. **Razvezi skladišče (fork)** v svoj GitHub račun
2. **Klonirajte svoj fork** lokalno 2. **Kloniraj svoj fork** lokalno
3. **Ustvarite novo vejo** za svoje spremembe 3. **Ustvari nov podal (branch)** za svoje spremembe
4. Izvedite spremembe na vsebini lekcij ali primerih kode 4. Naredi spremembe v vsebini lekcij ali primerih kode
5. Testirajte vse spremembe kode v ustreznih projektnih imenikih 5. Testiraj spremembe kode v ustreznih mapah projektov
6. Pošljite pull request po smernicah za prispevke 6. Pošlji pull requeste v skladu z navodili za prispevanje
### Za učence ### Za učence
1. Forkajte ali klonirajte repozitorij 1. Razvezi ali kloniraj skladišče
2. Postopoma obiščite mape lekcij 2. Pomakni se zaporedno skozi mape lekcij
3. Preberite datoteke README za vsako lekcijo 3. Preberi README datoteke za vsako lekcijo
4. Opravite pred-lekcijske kvize na https://ff-quizzes.netlify.app/web/ 4. Reši predlečnične kvize na https://ff-quizzes.netlify.app/web/
5. Delo z izvorno kodo v mapah lekcij 5. Delaj skozi primere kode v mapah lekcij
6. Opravite naloge in izzive 6. Dokončaj naloge in izzive
7. Opravite po-lekcijske kvize 7. Reši postlečnične kvize
### Živi razvoj ### Živ razvoj
- **Dokumentacija**: Zaženite `docsify serve` v korenski mapi (port 3000) - **Dokumentacija**: Zaženi `docsify serve` v korenu projekta (port 3000)
- **Quiz App**: Zaženite `npm run dev` v imeniku quiz-app - **Quiz App**: Zaženi `npm run dev` v mapi quiz-app
- **Projekti**: Uporabite razširitev VS Code Live Server za HTML projekte - **Projekti**: Uporabi razširitev VS Code Live Server za HTML projekte
- **API Projekti**: Zaženite `npm start` v ustreznih API imenikih - **API projekti**: Zaženi `npm start` v ustreznih API mapah
## Navodila za testiranje ## Navodila za testiranje
@ -110,88 +110,88 @@ python api.py
```bash ```bash
cd quiz-app cd quiz-app
npm run lint # Preveri morebitne težave s slogom kode npm run lint # Preveri težave s slogom kode
npm run build # Preveri, ali je gradnja uspešna npm run build # Preveri, ali je gradnja uspešna
``` ```
### Testiranje Banka API ### Testiranje Bank API
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm run lint # Preverite težave s slogom kode npm run lint # Preveri težave s slogom kode
node server.js # Preverite, ali se strežnik zažene brez napak node server.js # Preveri, ali strežnik zažene brez napak
``` ```
### Splošni pristop k testiranju ### Splošni pristop k testiranju
- To je izobraževalni repozitorij brez obsežnih samodejnih testov - To je učni repozitorij brez celovitega avtomatskega testiranja
- Ročno testiranje se osredotoča na: - Ročno testiranje se osredotoča na:
- Primerke kode tečejo brez napak - Primeri kode tečejo brez napak
- Povezave v dokumentaciji delujejo pravilno - Povezave v dokumentaciji delujejo pravilno
- Projekti se uspešno zgradijo - Projekti se uspešno zgradijo
- Primeri sledijo najboljšim praksam - Primeri sledijo najboljšim praksam
### Preverjanje pred oddajo ### Preverjanje pred oddajo
- Zaženite `npm run lint` v imenikih z package.json - Zaženi `npm run lint` v mapah z datoteko package.json
- Preverite, da so povezave v markdownu veljavne - Preveri veljavnost povezav v markdownu
- Testirajte primere kode v brskalniku ali Node.js - Testiraj primere kode v brskalniku ali Node.js
- Preverite, da prevodi ohranjajo pravilno strukturo - Preveri, da prevodi ohranjajo pravilno strukturo
## Smernice za stil kode ## Smernice za stil kode
### JavaScript ### JavaScript
- Uporabljajte sodobno sintakso ES6+ - Uporaba sodobne sintakse ES6+
- Sledite standardnim konfiguracijam ESLint, ki so v projektih - Sledenje standardnim ESLint konfiguracijam, podanim v projektih
- Upodobite razumljiva imena spremenljivk in funkcij za boljšo izobraževalno jasnost - Uporaba pomenljivih imen spremenljivk in funkcij za lažje razumevanje
- Dodajte komentarje za razlago konceptov za učence - Dodajanje komentarjev za pojasnitev konceptov za učence
- Uporabljajte Prettier kjer je konfiguriran - Formatiranje z uporabo Prettier kjer je konfigurirano
### HTML/CSS ### HTML/CSS
- Semantični elementi HTML5 - Semantični elementi HTML5
- Načela odzivne zasnove - Principi odzivnega oblikovanja
- Jasna poimenovanja razredov - Jasne konvencije poimenovanja razredov
- Komentarji, ki pojasnjujejo tehnike CSS za učence - Komentarji, ki pojasnjujejo CSS tehnike za učence
### Python ### Python
- Smernice sloga PEP 8 - Slediti smernicam sloga PEP 8
- Jasni, izobraževalni primeri kode - Jasni, izobraževalni primeri kode
- Tipizacije tam, kjer pomagajo pri učenju - Tipiziranje (type hints) kjer je koristno za učenje
### Markdown dokumentacija ### Dokumentacija v Markdownu
- Jasna hierarhija naslovov - Jasna hierarhija naslovov
- Bloki kode z označitvijo jezika - Bloki kode z navedbo jezika
- Povezave do dodatnih virov - Povezave do dodatnih virov
- Posnetki zaslona in slike v mapah `images/` - Posnetki zaslona in slike v mapah `images/`
- Alt besedilo za slike za dostopnost - Alt besedilo za slike zaradi dostopnosti
### Organizacija datotek ### Organizacija datotek
- Lekcije zaporedno številčene (1-getting-started-lessons, 2-js-basics, itd.) - Lekcije označene zaporedno (1-getting-started-lessons, 2-js-basics itd.)
- Vsak projekt ima mape `solution/` in pogosto `start/` ali `your-work/` - Vsak projekt ima mape `solution/` in pogosto `start/` ali `your-work/`
- Slike shranjene v lekcijsko-specifičnih mapah `images/` - Slike so shranjene v lekcijsko specifičnih mapah `images/`
- Prevodi v strukturi `translations/{jezikovna-koda}/` - Prevodi v strukturi `translations/{jezikovna-koda}/`
## Gradnja in namestitev ## Sestavljanje in nameščanje
### Namestitev Quiz App (Azure Static Web Apps) ### Namestitev Quiz App (Azure Static Web Apps)
Quiz-app je nastavljen za namestitev na Azure Static Web Apps: quiz-app je konfiguriran za nameščanje v Azure Static Web Apps:
```bash ```bash
cd quiz-app cd quiz-app
npm run build # Ustvari mapo dist/ npm run build # Ustvari mapo dist/
# Izvede namestitev preko GitHub Actions poteka dela ob potisku na main # Izvede namestitev prek GitHub Actions poteka ob potisku na main
``` ```
Azure Static Web Apps konfiguracija: Konfiguracija Azure Static Web Apps:
- **Lokacija aplikacije**: `/quiz-app` - **Lokacija aplikacije**: `/quiz-app`
- **Izhodna lokacija**: `dist` - **Izhodna lokacija**: `dist`
- **Delovni potek**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` - **Delovni tok**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Generiranje PDF dokumentacije ### Generiranje PDF dokumentacije
@ -204,79 +204,79 @@ npm run convert # Ustvari PDF iz docs
```bash ```bash
npm install -g docsify-cli # Namestite Docsify globalno npm install -g docsify-cli # Namestite Docsify globalno
docsify serve # Strežite na localhost:3000 docsify serve # Strežnik na localhost:3000
``` ```
### Projektno-specifične gradnje ### Gradnje specifične za projekte
Vsak projekt lahko ima lasten proces gradnje: Vsaka mapa projekta lahko ima lasten postopek gradnje:
- Vue projekti: `npm run build` ustvarja produkcijske pakete - Vue projekti: `npm run build` ustvari produkcijske pakete
- Statični projekti: brez gradnje, datoteke se postrežejo neposredno - Statični projekti: brez koraka gradnje, postreže se datoteke neposredno
## Smernice za pull requeste ## Smernice za pull requeste
### Oblika naslova ### Oblika naslova
Uporabljajte jasne, opisne naslove, ki označujejo področje sprememb: Uporabi jasne, opisne naslove, ki označujejo področje spremembe:
- `[Quiz-app] Dodaj nov kviz za lekcijo X` - `[Quiz-app] Dodaj nov kviz za lekcijo X`
- `[Lesson-3] Popravi tipkarsko napako v projektu terrarij` - `[Lesson-3] Popravi tipkarsko napako v projektu terarij`
- `[Translation] Dodaja španski prevod za lekcijo 5` - `[Translation] Dodaj španski prevod za lekcijo 5`
- `[Docs] Posodobitev navodil za nastavitev` - `[Docs] Posodobi navodila za nastavitev`
### Zahtevana preverjanja ### Zahtevani pregledi
Pred oddajo PR: Pred oddajo PR:
1. **Kakovost kode**: 1. **Kakovost kode**:
- Zaženite `npm run lint` v prizadetih projektnih imenikih - Zaženi `npm run lint` v prizadetih projektnih mapah
- Popravite vse napake in opozorila linterja - Odpravi vse napake in opozorila linterja
2. **Preverjanje gradnje**: 2. **Preverjanje gradnje**:
- Zaženite `npm run build`, če je potrebno - Zaženi `npm run build` če je potrebno
- Zagotovite, da ni napak pri gradnji - Prepričaj se, da ni napak pri gradnji
3. **Preverjanje povezav**: 3. **Preverjanje povezav**:
- Testirajte vse povezave v markdownu - Testiraj vse markdown povezave
- Preverite, da reference do slik delujejo - Preveri delovanje referenc slik
4. **Pregled vsebine**: 4. **Pregled vsebine**:
- Preverite pravopis in slovnico - Preveri pravopis in slovnico
- Prepričajte se, da so primeri kode pravilni in izobraževalni - Zagotovi, da so primeri kode pravilni in poučni
- Preverite, da prevodi ohranjajo prvotni pomen - Preveri, da prevodi ohranjajo originalni pomen
### Zahteve za prispevek ### Zahteve za prispevanje
- Soglasje z Microsoft CLA (samodejno preverjanje ob prvem PR-ju) - Strinjanje z Microsoft CLA (avtomatizirana kontrola ob prvem PR)
- Sledite [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) - Sledenje [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Ogled [CONTRIBUTING.md](./CONTRIBUTING.md) za podrobna navodila - Glej [CONTRIBUTING.md](./CONTRIBUTING.md) za podrobna navodila
- V opis PR vključite številke zadev, če je primerno - Navedi številke issue-ov v opisu PR, če je primerno
### Postopek pregleda ### Pregledni postopek
- PR-e pregledujejo vzdrževalci in skupnost - PR-je pregledajo vzdrževalci in skupnost
- Prioriteta je izobraževalna jasnost - Prioriteta je izobraževalna jasnost
- Primeri kode naj sledijo sodobnim najboljšim praksam - Primeri kode sledijo najboljšim trenutnim praksam
- Prevodi se pregledajo glede natančnosti in kulturne primernosti - Prevodi se pregledajo za natančnost in kulturno ustreznost
## Sistem za prevajanje ## Sistem prevajanja
### Samodejni prevod ### Avtomatizirani prevod
- Uporablja GitHub Actions z delovnim tokom co-op-translator - Uporablja GitHub Actions z delovnim tokom co-op-translator
- Prevede v več kot 50 jezikov samodejno - Samodejno prevaja v več kot 50 jezikov
- Izvorne datoteke v glavnih imenikih - Izvorne datoteke so v glavnih direktorijih
- Prevedene datoteke v imenikih `translations/{jezikovna-koda}/` - Prevedene datoteke v `translations/{jezikovna-koda}/`
### Dodajanje ročnih izboljšav prevoda ### Dodajanje ročnih izboljšav prevodov
1. Poiščite datoteko v `translations/{jezikovna-koda}/` 1. Najdi datoteko v `translations/{jezikovna-koda}/`
2. Izvedite izboljšave ob ohranjanju strukture 2. Naredi izboljšave, ob ohranitvi strukture
3. Poskrbite, da primeri kode ostanejo funkcionalni 3. Poskrbi, da primeri kode ostanejo funkcionalni
4. Testirajte vsak lokalizirani kviz 4. Testiraj lokalizirano vsebino kvizov
### Metapodatki prevoda ### Metapodatki prevodov
Prevedene datoteke vsebujejo glavo z metapodatki: Prevedene datoteke vključujejo meta glavo:
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
--> -->
``` ```
## Odpravljanje napak in reševanje težav ## Razhroščevanje in odpravljanje težav
### Pogoste težave ### Pogoste težave
**Quiz app se ne zažene**: **Quiz app ne zažene**:
- Preverite verzijo Node.js (priporočeno v14+) - Preveri verzijo Node.js (priporočena v14+)
- Izbrišite `node_modules` in `package-lock.json`, znova zaženite `npm install` - Izbriši `node_modules` in `package-lock.json`, ponovno zaženi `npm install`
- Preverite konflikte porte (privzeto: Vite uporablja port 5173) - Preveri morebitne konflikte vrat (privzeto: Vite uporablja port 5173)
**API strežnik se ne zažene**: **API strežnik se ne zažene**:
- Preverite, da verzija Node.js ustreza minimalni zahtevani (node >=10) - Preveri verzijo Node.js (node >=10)
- Preverite, ali je port že zaseden - Preveri, če je port že v uporabi
- Preverite, da so vse odvisnosti nameščene z `npm install` - Poskrbi, da so vse odvisnosti nameščene z `npm install`
**Razširitev brskalnika se ne naloži**: **Razširitev brskalnika se ne naloži**:
- Preverite, da je manifest.json pravilno oblikovan - Preveri, da je manifest.json pravilno oblikovan
- Preverite konzolo brskalnika za napake - Preveri konzolo brskalnika za napake
- Sledite navodilom za namestitev, specifičnim za brskalnik - Sledi navodilom za namestitev specifičnim za brskalnik
**Težave s Python klepetalnim projektom**: **Težave s projektom klepeta v Pythonu**:
- Poskrbite, da je paket OpenAI nameščen: `pip install openai` - Namesti paket OpenAI: `pip install openai`
- Preverite, da je okoljska spremenljivka GITHUB_TOKEN nastavljena - Preveri, da je okoljska spremenljivka GITHUB_TOKEN nastavljena
- Preverite dostopna dovoljenja za GitHub Models - Preveri dovoljenja za dostop do GitHub modelov
**Docsify ne postreže dokumentacije**: **Docsify ne postreže dokumentacije**:
- Namestite docsify-cli globalno: `npm install -g docsify-cli` - Namesti docsify-cli globalno: `npm install -g docsify-cli`
- Zaženite z korenske mape repozitorija - Zaženi v korenski mapi skladišča
- Preverite, da datoteka `docs/_sidebar.md` obstaja - Preveri obstoj `docs/_sidebar.md`
### Nasveti za razvojno okolje ### Nasveti za razvojno okolje
- Uporabljajte VS Code z razširitvijo Live Server za HTML projekte - Uporabljaj VS Code z razširitvijo Live Server za HTML projekte
- Namestite razširitve ESLint in Prettier za dosledno oblikovanje - Namesti razširitve ESLint in Prettier za skladno oblikovanje
- Uporabite orodja brskalnika za odpravljanje napak v JavaScriptu - Uporabljaj DevTools brskalnika za razhroščevanje JavaScript-a
- Za Vue projekte namestite Vue DevTools razširitev za brskalnik - Za Vue projekte namesti Vue DevTools brskalniško razširitev
### Razmisleki o zmogljivosti ### Upoštevanje zmogljivosti
- Veliko število prevedenih datotek (več kot 50 jezikov) pomeni, da so kloni veliki - Veliko število prevedenih datotek (več kot 50 jezikov) pomeni velike polne klone
- Za delo samo z vsebino uporabite plitek klon: `git clone --depth 1` - Uporabi plitki klon, če delaš le na vsebini: `git clone --depth 1`
- Izključite prevode iz iskanja, ko delate v angleški vsebini - Izključi prevode iz iskanj, ko delaš na angleški vsebini
- Procesi gradnje so lahko počasni pri prvem zagonu (npm install, Vite build) - Procesi gradnje so lahko počasnejši ob prvem zagonu (npm install, Vite build)
## Varnostni vidiki ## Varnostni vidiki
### Okoljske spremenljivke ### Okoljske spremenljivke
- API ključi se nikoli ne smejo shranjevati v repozitorij - Ključi API ne smejo biti nikoli vključeni v repozitorij
- Uporabljajte `.env` datoteke (že dodane v `.gitignore`) - Uporabljaj `.env` datoteke (že vključene v `.gitignore`)
- Dokumentirajte zahtevane okoljske spremenljivke v README-jih projektov - Dokumentiraj potrebne okoljske spremenljivke v README-jih projektov
### Python projekti ### Python projekti
- Uporabljajte virtualna okolja: `python -m venv venv` - Uporabljaj virtualna okolja: `python -m venv venv`
- Posodabljajte odvisnosti - Posodabljaj odvisnosti
- GitHub tokeni naj imajo minimalna potrebna dovoljenja - GitHub tokeni naj imajo minimalne potrebne pravice
### Dostop do GitHub Models ### Dostop do GitHub modelov
- Za GitHub Models so potrebni osebni dostopni žetoni (PAT) - Za GitHub modele so potrebni osebni dostopni tokeni (PAT)
- Ti žetoni naj se shranjujejo kot okoljske spremenljivke - Tokeni morajo biti shranjeni kot okoljske spremenljivke
- Žetonov ali poverilnic nikoli ne oddajajte v repozitorij - Tokenov ali poverilnic nikoli ne vključi v repozitorij
## Dodatne opombe ## Dodatne opombe
### Ciljna publika ### Ciljna publika
- Popolni začetniki v spletni razvoj - Popolni začetniki v spletni razvoj
- Študenti in samostojni učenci - Študenti in samouki
- Učitelji, ki uporabljajo kurikulum v razredih - Učitelji, ki uporabljajo učni načrt v razredih
- Vsebina je zasnovana za dostopnost in postopno nabiranje znanja - Vsebina je zasnovana za dostopnost in postopno gradnjo veščin
### Izobraževalna filozofija ### Izobraževalna filozofija
- Pristop učenja na podlagi projektov - Pristop učenja na osnovi projektov
- Pogoste preveritve znanja (kvizi) - Pogoste preveritve znanja (kvizi)
- Praktične vaje kodiranja - Praktične vaje programiranja
- Primeri iz resničnega sveta - Primeri uporabe iz realnega sveta
- Osredotočenost na osnove pred okvirji (frameworki) - Osredotočenost na osnove pred ogrodji
### Vzdrževanje repozitorija ### Vzdrževanje skladišča
- Aktivna skupnost učencev in prispevkarjev - Aktivna skupnost učencev in prispevajočih
- Redne posodobitve odvisnosti in vsebine - Redne posodobitve odvisnosti in vsebine
- Spremljanje zadev in razprav s strani vzdrževalcev - Vzdrževalci nadzorujejo težave in razprave
- Prevodi se posodabljajo samodejno preko GitHub Actions - Prevodi se posodabljajo avtomatsko preko GitHub Actions
### Povezani viri ### Sorodni viri
- [Microsoft Learn moduli](https://docs.microsoft.com/learn/) - [Moduli Microsoft Learn](https://docs.microsoft.com/learn/)
- [Student Hub viri](https://docs.microsoft.com/learn/student-hub/) - [Viri Student Hub](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) priporočeno za učence - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) priporočeno za učence
- Dodatni tečaji: Generativna umetna inteligenca, podatkovna znanost, ML, IoT kurikuli na voljo - Dodatni tečaji: Generativna AI, Data Science, ML, IoT učni načrti na voljo
### Delo z določenimi projekti ### Delo z določenimi projekti
Za podrobna navodila o posameznih projektih si oglejte datoteke README v: Za podrobna navodila o posameznih projektih glej README datoteke v:
- `quiz-app/README.md` - Vue 3 aplikacija za kvize - `quiz-app/README.md` - Vue 3 aplikacija kviza
- `7-bank-project/README.md` - Bančna aplikacija z avtentikacijo - `7-bank-project/README.md` - Bančna aplikacija z avtentikacijo
- `5-browser-extension/README.md` - Razvoj razširitve brskalnika - `5-browser-extension/README.md` - Razvoj razširitve brskalnika
- `6-space-game/README.md` - Razvoj igre na podlagi Canvas - `6-space-game/README.md` - Razvoj igre na platnu (Canvas)
- `9-chat-project/README.md` - Projekt AI klepetalnega asistenta - `9-chat-project/README.md` - Projekt AI klepetalnega pomočnika
### Struktura Monorepo ### Struktura monorepo
Čeprav ni tradicionalni monorepo, ta repozitorij vsebuje več neodvisnih projektov: Čeprav ni tradicionalni monorepo, to skladišče vsebuje več samostojnih projektov:
- Vsaka lekcija je samostojna - Vsaka lekcija je samostojna
- Projekti ne delijo odvisnosti - Projekti ne delijo odvisnosti
- Delajte na posameznih projektih brez vpliva na druge - Delo na posameznih projektih brez vpliva na druge
- Klonite celoten repozitorij za popolno izkušnjo kurikuluma - Kloniraj celotno skladišče za celotno učni izkušnjo
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Omejitev odgovornosti**: **Omejitev odgovornosti**:
Ta dokument je bil preveden z uporabo storitve za strojno prevajanje [Co-op Translator](https://github.com/Azure/co-op-translator). Čeprav si prizadevamo za pravilnost, upoštevajte, da avtomatizirani prevodi lahko vsebujejo napake ali netočnosti. Izvirni dokument v svojem matičnem jeziku velja za avtoritativni vir. Za kritične informacije priporočamo strokovni človeški prevod. Za morebitna nesporazume ali napačne razlage, ki izhajajo iz uporabe tega prevoda, ne odgovarjamo. Ta dokument je bil preveden z uporabo storitve za prevajanje z umetno inteligenco [Co-op Translator](https://github.com/Azure/co-op-translator). Čeprav si prizadevamo za točnost, vas opozarjamo, da avtomatizirani prevodi lahko vsebujejo napake ali netočnosti. Izvirni dokument v njegovem izvirnem jeziku je treba obravnavati kot avtoritativni vir. Za ključne informacije priporočamo strokovni človeški prevod. Nismo odgovorni za morebitna nesporazume ali nepravilne interpretacije, ki izhajajo iz uporabe tega prevoda.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T16:59:48+00:00", "translation_date": "2026-04-20T16:20:52+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "sr" "language_code": "sr"
}, },

@ -1,47 +1,47 @@
# AGENTS.md # AGENTS.md
## Pregled projekta ## Преглед пројекта
Ovo je repozitorijum obrazovnog kurikuluma za podučavanje osnova web razvoja za početnike. Kurikulum je sveobuhvatan 12-nedeljski kurs koji su razvili Microsoft Cloud Advocates, i sadrži 24 praktične lekcije koje pokrivaju JavaScript, CSS i HTML. Ово је репозиторијум едукативног курикулума за подучавање основа веб развоја почетницима. Курикулум је свеобухватан курс у трајању од 12 недеља, развијен од стране Microsoft Cloud Advocates-а, који садржи 24 практичне лекције које обухватају JavaScript, CSS и HTML.
### Ključne komponente ### Кључне компоненте
- **Obrazovni sadržaj**: 24 strukturirane lekcije organizovane u module zasnovane na projektima - **Едукативни садржај**: 24 структурисане лекције организоване у модуле засноване на пројектима
- **Praktični projekti**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor i AI Chat Assistant - **Практични пројекти**: Терраријум, Игра куцања, Прегледачки екстензија, Свемирска игра, Банкарска апликација, Уређивач кода и AI чат асистент
- **Interaktivni kvizovi**: 48 kvizova sa po 3 pitanja (testovi pre i posle lekcija) - **Интерактивни квизови**: 48 квизова са по 3 питања (пре/после лекције)
- **Podrška za više jezika**: Automatski prevodi na više od 50 jezika putem GitHub Actions - **Подршка за више језика**: Аутоматизовани преводи за више од 50 језика преко GitHub Actions
- **Tehnologije**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (za AI projekte) - **Технолошки стек**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (за AI пројекте)
### Arhitektura ### Архитектура
- Obrazovni repozitorijum sa strukturom baziranom na lekcijama - Едукативни репозиторијум са структуром заснованом на лекцијама
- Svaka fascikla lekcije sadrži README, primere koda i rešenja - Свако говорно место садржи README, примере кода и решења
- Samostalni projekti u posebnim direktorijumima (quiz-app, različiti projekti lekcija) - Самостални пројекти у посебним директивама (quiz-app, разни пројекти лекција)
- Sistem za prevod koristeći GitHub Actions (co-op-translator) - Систем превођења користећи GitHub Actions (co-op-translator)
- Dokumentacija se servisira putem Docsify i dostupna je kao PDF - Документација се сервира преко Docsify и доступна је као PDF
## Komande za podešavanje ## Команде за подешавање
Ovaj repozitorijum je prvenstveno za konzumiranje obrazovnog sadržaja. Za rad sa određenim projektima: Овај репозиторијум је првенствено намењен за коришћење едукативног садржаја. За рад са одређеним пројектима:
### Podešavanje glavnog repozitorijuma ### Главно подешавање репозиторијума
```bash ```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners cd Web-Dev-For-Beginners
``` ```
### Podešavanje Quiz aplikacije (Vue 3 + Vite) ### Подешавање Quiz App-а (Vue 3 + Vite)
```bash ```bash
cd quiz-app cd quiz-app
npm install npm install
npm run dev # Покрени сервер за развој npm run dev # Покрени сервер за развој
npm run build # Направи верзију за продукцију npm run build # Изгради за продукцију
npm run lint # Покрени ESLint npm run lint # Покрени ESLint
``` ```
### API Bankarskog projekta (Node.js + Express) ### API за банкарски пројекат (Node.js + Express)
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
@ -51,15 +51,15 @@ npm run lint # Покрени ESLint
npm run format # Форматирај помоћу Prettier-а npm run format # Форматирај помоћу Prettier-а
``` ```
### Projekti za Browser Extension ### Пројекти прегледачких екстензија
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
npm install npm install
# Пратите упутства за учитавање екстензија специфичних за претраживач # Следите упутства за учитавање екстензија специфичних за прегледач
``` ```
### Projekti za Space Game ### Пројекти свемирске игре
```bash ```bash
cd 6-space-game/solution cd 6-space-game/solution
@ -67,7 +67,7 @@ npm install
# Отворите index.html у прегледачу или користите Live Server # Отворите index.html у прегледачу или користите Live Server
``` ```
### Chat projekat (Python backend) ### Чат пројекат (Python backend)
```bash ```bash
cd 9-chat-project/solution/backend/python cd 9-chat-project/solution/backend/python
@ -76,207 +76,207 @@ pip install openai
python api.py python api.py
``` ```
## Razvojni tok rada ## Радни ток развоја
### Za saradnike na sadržaju ### За сараднике на садржају
1. **Forkujte repozitorijum** na svoj GitHub nalog 1. **Направите форк репозиторијума** на свој GitHub налог
2. **Klonirajte vaš fork** lokalno 2. **Клонирајте свој форк** локално
3. **Kreirajte novu granu** za vaše izmene 3. **Креирајте нову грану** за ваше измене
4. Izmenite sadržaj lekcija ili primere koda 4. Уредите садржај лекција или примере кода
5. Testirajte bilo koje izmene koda u relevantnim direktorijumima projekata 5. Тестирајте измене кода у одговарајућим проектним директоријумима
6. Podnesite pull zahteve u skladu sa smernicama za doprinos 6. По савету упућујте pull request-ове према правилима доприноса
### Za učenike ### За ученике
1. Forkujte ili klonirajte repozitorijum 1. Форкујте или клонирајте репозиторијум
2. Posetite direktorijume lekcija redom 2. Идите кроз директоријуме лекција по редоследу
3. Čitajte README fajlove za svaku lekciju 3. Читајте README фајлове за сваку лекцију
4. Završite pre-lesson kvizove na https://ff-quizzes.netlify.app/web/ 4. Завршите квизове пре лекције на https://ff-quizzes.netlify.app/web/
5. Radite kroz primere koda u fasciklama lekcija 5. Радите на примерима кода у директоријумима лекција
6. Završite zadatke i izazove 6. Завршите задатке и изазове
7. Uradite post-lesson kvizove 7. Полажите квизове после лекције
### Živi razvoj ### Ливе развој
- **Dokumentacija**: Pokrenite `docsify serve` u root direktorijumu (port 3000) - **Документација**: Покрените `docsify serve` у корену (порт 3000)
- **Quiz App**: Pokrenite `npm run dev` u direktorijumu quiz-app - **Quiz App**: Покрените `npm run dev` у директоријуму quiz-app
- **Projekti**: Koristite VS Code Live Server ekstenziju za HTML projekte - **Пројекти**: Користите VS Code Live Server екстензију за HTML пројекте
- **API Projekti**: Pokrenite `npm start` u odgovarajućim API direktorijumima - **API пројекти**: Покрените `npm start` у одговарајућим API директоријумима
## Uputstva za testiranje ## Упутства за тестирање
### Testiranje Quiz aplikacije ### Тестирање Quiz App-а
```bash ```bash
cd quiz-app cd quiz-app
npm run lint # Провери проблеме у стилу кода npm run lint # Провери да ли постоје проблеми са стилом кода
npm run build # Потврди да израда успешно прође npm run build # Потврди да ли је изградња успешна
``` ```
### Testiranje Bank API-ja ### Тестирање Bank API-ја
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm run lint # Проверите стил кода за проблеме npm run lint # Проверите проблеме са стилом кода
node server.js # Потврдите да сервер покреће без грешака node server.js # Проверите да ли сервер почиње без грешака
``` ```
### Opšti pristup testiranju ### Општи приступ тестирању
- Ovo je obrazovni repozitorijum bez sveobuhvatnih automatizovanih testova - Ово је едукативни репозиторијум без обимних аутоматизованих тестова
- Ručno testiranje se fokusira na: - Ручно тестирање се фокусира на:
- Primere koda koji rade bez grešaka - Покретање примера кода без грешки
- Linkove u dokumentaciji koji funkcionišu ispravno - Провера исправности линкова у документацији
- Uspešne build procese projekata - Успешно компајлирање пројеката
- Primeri koji slede najbolje prakse - Примери прате најбоље праксе
### Provere pre podnošenja ### Провере пре слања
- Pokrenite `npm run lint` u direktorijumima sa package.json - Покрените `npm run lint` у директоријумима са package.json
- Proverite da li su markdown linkovi važeći - Верификујте да су markdown линкови важећи
- Testirajte primere koda u pregledaču ili Node.js - Тестирајте примере кода у прегледачу или Node.js
- Proverite da li prevodi održavaju pravilnu strukturu - Проверите да преводи одржавају исправну структуру
## Smernice za stil koda ## Смјернице за стил кода
### JavaScript ### JavaScript
- Koristite modernu ES6+ sintaksu - Користите савремени ES6+ синтакс
- Pratite standardne ESLint konfiguracije u projektima - Пратите ESLint конфигурације које су укључене у пројекте
- Koristite smislene nazive promenljivih i funkcija radi jasnoće u obrazovanju - Користите смислене називе варијабли и функција ради едукативне јасноће
- Dodajte komentare koji objašnjavaju koncepte za učenike - Додајте коментаре који објашњавају концепте ученицима
- Formatirajte koristeći Prettier tamo gde je konfigurisano - Форматирајте помоћу Prettier-а где је подешено
### HTML/CSS ### HTML/CSS
- Semantički HTML5 elementi - Семантички HTML5 елементи
- Principi responzivnog dizajna - Принципи респонзивног дизајна
- Jasne konvencije imenovanja klasa - Јасне конвенције именовања класа
- Komentari koji objašnjavaju CSS tehnike za učenike - Коментари који објашњавају CSS технике за ученике
### Python ### Python
- PEP 8 smernice za stil - Пратите PEP 8 смернице
- Jasni, obrazovni primeri koda - Јасни, едукативни пример кода
- Tipizacija gde je korisno za učenje - Типске наговештаје где су корисни за учење
### Markdown dokumentacija ### Markdown документација
- Jasna hijerarhija naslova - Јасна хијерархија заглавља
- Kod blokovi sa specificiranim jezikom - Блокови кода са спецификацијом језика
- Linkovi ka dodatnim resursima - Линкови ка додатним ресурсима
- Snimci ekrana i slike u `images/` direktorijumima - Снимци екрана и слике у директоријуму `images/`
- Alternativni tekst za slike radi pristupačnosti - Алт текст за слике ради приступачности
### Organizacija fajlova ### Организација фајлова
- Lekcije numerisane sekvencijalno (1-getting-started-lessons, 2-js-basics, itd.) - Лекције нумерисане секвенцијално (1-getting-started-lessons, 2-js-basics, итд.)
- Svaki projekat ima `solution/` i često `start/` ili `your-work/` direktorijume - Свaki пројекат има `solution/` и често `start/` или `your-work/` директоријуме
- Slike se čuvaju u lekcijsko-specifičnim `images/` fasciklama - Слике се чувају у директоријумима лекција `images/`
- Prevod u strukturi `translations/{language-code}/` - Преводи у структури `translations/{language-code}/`
## Izgradnja i implementacija ## Састављање и деплојмент
### Implementacija Quiz aplikacije (Azure Static Web Apps) ### Деплоент Quiz App-а (Azure Static Web Apps)
quiz-app je konfigurisan za implementaciju na Azure Static Web Apps: quiz-app је конфигурисан за деплоент на Azure Static Web Apps:
```bash ```bash
cd quiz-app cd quiz-app
npm run build # Креира фасциклу dist/ npm run build # Креира фолдер dist/
# Објављује преко GitHub Actions рада на додавање у main грану # Деплојује путем GitHub Actions workflow-а приликом пуша на main
``` ```
Konfiguracija Azure Static Web Apps: Конфигурација Azure Static Web Apps:
- **Lokacija aplikacije**: `/quiz-app` - **Локација апликације**: `/quiz-app`
- **Output lokacija**: `dist` - **Локација излаза**: `dist`
- **Tok rada**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Generisanje PDF dokumentacije ### Генерисање PDF документације
```bash ```bash
npm install # Инсталирај docsify-to-pdf npm install # Инсталирајте docsify-to-pdf
npm run convert # Генериши PDF из документације npm run convert # Генеришите PDF из докса
``` ```
### Docsify dokumentacija ### Docsify документација
```bash ```bash
npm install -g docsify-cli # Инсталирајте Docsify глобално npm install -g docsify-cli # Инсталирајте Docsify глобално
docsify serve # Пуштајте на localhost:3000 docsify serve # Покрените на localhost:3000
``` ```
### Build procesi specifični za projekte ### Састављање специфично за пројекат
Svaki direktorijum projekta može imati svoj build proces: Свaki директоријум пројекта може имати свој процес састављања:
- Vue projekti: `npm run build` kreira produkcione pakete - Vue пројекти: `npm run build` креира продукцијске пакете
- Statički projekti: Nema koraka izgradnje, fajlovi se direktno serviraju - Статички пројекти: нема корака састављања, сервирање фајлова директно
## Smernice za pull zahteve ## Смјернице за pull request-ове
### Format naslova ### Формат наслова
Koristite jasne, opisne naslove koji ukazuju na oblast izmene: Користите јасне, описне наслове који указују на област измене:
- `[Quiz-app] Dodajte novi kviz za lekciju X` - `[Quiz-app] Додај нови квиз за лекцију X`
- `[Lesson-3] Ispravka greške u terrarium projektu` - `[Lesson-3] Поправи правописну грешку у терраријум пројекту`
- `[Translation] Dodajte španski prevod za lekciju 5` - `[Translation] Додај шпански превод за лекцију 5`
- `[Docs] Ažurirajte uputstva za podešavanje` - `[Docs] Ажурирај упутства за подешавање`
### Potrebne provere ### Обавезне провере
Pre podnošenja PR: Пре слања PR-а:
1. **Kvalitet koda**: 1. **Квалитет кода**:
- Pokrenite `npm run lint` u pogođenim projekt direktorijumima - Покрените `npm run lint` у погођеним пројектним директоријумима
- Ispravite sve lint greške i upozorenja - Исправите све грешке и упозорења
2. **Provera build-a**: 2. **Верификација састављања**:
- Pokrenite `npm run build` ako je potrebno - Покрените `npm run build` ако је примењиво
- Osigurajte da nema grešaka u build-u - Уверите се да нема грешки у састављању
3. **Validacija linkova**: 3. **Провера линкова**:
- Testirajte sve markdown linkove - Тестирајте све markdown линкове
- Proverite da reference slika funkcionišu - Проверите да референце гу сликама раде
4. **Pregled sadržaja**: 4. **Преглед садржаја**:
- Pročitajte radi pravopisa i gramatike - Прегледајте правопис и граматику
- Osigurajte da su primeri koda ispravni i obrazovni - Уверите се да су примери кода исправни и едукативни
- Proverite da prevodi održavaju originalno značenje - Верификујте да преводи одржавају оригинално значење
### Zahtevi za doprinos ### Захтеви за допринос
- Prihvatite Microsoft CLA (automatska provera prilikom prvog PR-a) - Прихватите Microsoft CLA (аутоматска провера при првом PR-у)
- Pratite [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) - Пратите [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Pogledajte [CONTRIBUTING.md](./CONTRIBUTING.md) za detaljne smernice - Погледајте [CONTRIBUTING.md](./CONTRIBUTING.md) за детаљна упутства
- Referencirajte brojeve problema u opisu PR-a ako je primenljivo - Наведите бројеве issue-ја у опису PR-а ако је применљиво
### Proces revizije ### Процес рецензије
- PR-ove pregledaju održavaoci i zajednica - PR-ове рецензирају одржаваоци и заједница
- Prioritet je obrazovna jasnoća - Приоритет је јасноћа едукације
- Primeri koda treba da slede najnovije najbolje prakse - Примери кода треба да прате савремене најбоље праксе
- Prevod se proverava za tačnost i kulturnu prikladnost - Преводи су рецензирани за тачност и културну прикладност
## Sistem za prevod ## Систем превођења
### Automatski prevod ### Аутоматски превод
- Koristi GitHub Actions sa co-op-translator workflow-om - Користи GitHub Actions са co-op-translator workflow-ом
- Automatski prevodi na više od 50 jezika - Аутоматски преводи на више од 50 језика
- Izvorni fajlovi u glavnim direktorijumima - Изворни фајлови у главним директоријумима
- Prevedeni fajlovi u `translations/{language-code}/` direktorijumima - Преведени фајлови у директоријумима `translations/{language-code}/`
### Dodavanje manuelnih poboljšanja prevoda ### Додавање ручних побољшања превода
1. Pronađite fajl u `translations/{language-code}/` 1. Пронађите фајл у `translations/{language-code}/`
2. Napravite poboljšanja uz očuvanje strukture 2. Унесите побољшања уз очување структуре
3. Osigurajte da primeri koda ostanu funkcionalni 3. Уверите се да примери кода и даље функционишу
4. Testirajte lokalizovani sadržaj kvizova 4. Тестирајте преведене квиз садржаје
### Metapodaci prevoda ### Мета подаци о преводима
Prevedeni fajlovi uključuju zaglavlje sa metapodacima: Преведени фајлови садрже мета заглавље:
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
--> -->
``` ```
## Debugovanje i rešavanje problema ## Дебаговање и решавање проблема
### Uobičajeni problemi ### Чести проблеми
**Quiz app ne može da se pokrene**: **Quiz app не може да се покрене**:
- Proverite verziju Node.js (preporučena v14+) - Проверите верзију Node.js (рекомандовано v14+)
- Obrišite `node_modules` i `package-lock.json`, zatim pokrenite `npm install` - Обришите `node_modules` и `package-lock.json`, па покрените `npm install` поново
- Proverite sukobe portova (podrazumevano: Vite koristi port 5173) - Проверите да нема сукоба портова (подразумевано: Vite користи порт 5173)
**API server ne može da se pokrene**: **API сервер не покреће се**:
- Proverite da li je verzija Node.js minimalna (node >=10) - Верификујте да је Node.js верзија >=10
- Proverite da li je port zauzet - Проверите да ли је порт већ у употреби
- Uverite se da su svi zavisni paketi instalirani sa `npm install` - Уверите се да су све зависности инсталиране помоћу `npm install`
**Browser extension se ne učitava**: **Прегледачки екстензија се не учитава**:
- Proverite da li je manifest.json pravilno formatiran - Проверите да ли је manifest.json правилно форматиран
- Proverite konzolu browser-a za greške - Погледајте конзолу прегледача због грешака
- Pratite uputstva za instalaciju proširenja specifična za pretraživač - Пратите упутства за инсталацију екстензије специфична за прегледач
**Problemi sa Python chat projektom**: **Проблеми са Python чат пројектом**:
- Osigurajte da je instaliran OpenAI paket: `pip install openai` - Проверите да је OpenAI пакет инсталиран: `pip install openai`
- Proverite da je postavljena promenljiva okruženja GITHUB_TOKEN - Верификујте да је GITHUB_TOKEN подешен као environment варијабла
- Proverite dozvole za pristup GitHub Models - Проверите приступе GitHub Models
**Docsify ne servira dokumentaciju**: **Docsify не служи документацију**:
- Instalirajte docsify-cli globalno: `npm install -g docsify-cli` - Инсталирајте docsify-cli глобално: `npm install -g docsify-cli`
- Pokrenite iz root direktorijuma repozitorijuma - Покрените из кореног директоријума репозиторијума
- Proverite da `docs/_sidebar.md` postoji - Проверите да `docs/_sidebar.md` постоји
### Saveti za razvojno okruženje ### Савети за развојно окружење
- Koristite VS Code sa Live Server ekstenzijom za HTML projekte - Користите VS Code са Live Server екстензијом за HTML пројекте
- Instalirajte ESLint i Prettier ekstenzije za dosledno formatiranje - Инсталирајте ESLint и Prettier екстензије за доследно форматирање
- Koristite DevTools u pregledaču za debugovanje JavaScript-a - Користите прегледачке DevTools за дебаговање JavaScript-а
- Za Vue projekte, instalirajte Vue DevTools ekstenziju za pretraživač - За Vue пројекте, инсталирајте Vue DevTools прегледачку екстензију
### Razmatranja performansi ### Разматрања перформанси
- Veliki broj prevedenih fajlova (50+ jezika) znači da su potpuni klonovi veliki - Велики број преведених фајлова (више од 50 језика) значи да су пун клонирања велики
- Koristite plitak klon ako radite samo na sadržaju: `git clone --depth 1` - Користите shallow clone ако радите само на садржају: `git clone --depth 1`
- Isključite prevode iz pretraga kada radite na engleskom sadržaju - Искључите преводе из претрага када радите на енглеском садржају
- Build procesi mogu biti spori pri prvom pokretanju (npm install, Vite build) - Процеси састављања могу бити спори при првом покретању (npm install, Vite build)
## Bezbednosna razmatranja ## Безбедносне напомене
### Promenljive okruženja ### Environment варијабле
- API ključevi nikada ne treba da budu commitovani u repozitorijum - API кључеви никада не смеју бити пуштени у репозиторијум
- Koristite `.env` fajlove (već u `.gitignore`) - Користите `.env` фајлове (већ имају `.gitignore`)
- Dokumentujte potrebne promenljive okruženja u README fajlovima projekata - Документујте потребне environment варијабле у README-јима пројеката
### Python projekti ### Python пројекти
- Koristite virtuelna okruženja: `python -m venv venv` - Користите virtual окружје: `python -m venv venv`
- Držite zavisnosti ažurnim - Одржавајте зависности ажурним
- GitHub tokeni treba da imaju minimalne potrebne dozvole - GitHub токени треба да имају минималне потребне дозволе
### Pristup GitHub Models ### Приступ GitHub Models
- Personal Access Tokens (PAT) su potrebni za GitHub Models - Потребни су Personal Access Tokens (PAT)
- Tokeni treba da budu čuvani kao promenljive okruženja - Токени треба да се чувају као environment варијабле
- Nikada nemojte commitovati tokene ili lozinke - Никада не пуштајте токене или акредитиве у репозиторијум
## Dodatne napomene ## Додатне напомене
### Ciljna publika ### Циљна публика
- Potpuni početnici u web razvoju - Потпуни почетници у веб развоју
- Studenti i samouci - Студенти и самоуки
- Nastavnici koji koriste kurikulum u učionicama - Наставници који користе курикулум у учионицама
- Sadržaj je dizajniran za pristupačnost i postepeno sticanje veština - Садржај је дизајниран за приступачност и постепено грађење вештина
### Obrazovna filozofija ### Едукативна филозофија
- Pristup učenja zasnovan na projektima - Приступ учењу заснован на пројектима
- Česte provere znanja (kvizovi) - Честа провера знања (квизови)
- Praktične vežbe programiranja - Практичне вежбе кодирања
- Primeri primene u stvarnom svetu - Примери из стварног света
- Fokus na osnove pre okvira - Фокус на основе пре framework-a
### Održavanje repozitorijuma ### Одржавање репозиторијума
- Aktivna zajednica učenika i saradnika - Активна заједница ученика и сарадника
- Redovna ažuriranja zavisnosti i sadržaja - Редовна ажурирања зависности и садржаја
- Održavaoci prate probleme i diskusije - Пратите проблеме и дискусије од стране одржавалаца
- Ažuriranja prevoda su automatizovana preko GitHub Actions - Аутоматско ажурирање превода преко GitHub Actions
### Povezani resursi ### Повезани ресурси
- [Microsoft Learn moduli](https://docs.microsoft.com/learn/) - [Microsoft Learn модули](https://docs.microsoft.com/learn/)
- [Student Hub resursi](https://docs.microsoft.com/learn/student-hub/) - [Student Hub ресурси](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) preporučen za učenike - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) препоручен за ученике
- Dodatni kursevi: Generativni AI, Data Science, ML, IoT kurikulumi dostupni - Додатни курсови: Генеративни AI, Наука о подацима, ML, IoT курикулуми
### Rad sa određenim projektima ### Рад са појединачним пројектима
Za detaljna uputstva o pojedinačnim projektima, pogledajte README fajlove u: За детаљна упутства о појединачним пројектима погледајте README фајлове у:
- `quiz-app/README.md` - Vue 3 aplikacija za kviz - `quiz-app/README.md` - Vue 3 квиз апликација
- `7-bank-project/README.md` - Bankarska aplikacija sa autentifikacijom - `7-bank-project/README.md` - Банкарска апликација са аутентификацијом
- `5-browser-extension/README.md` - Razvoj browser ekstenzije - `5-browser-extension/README.md` - Развој прегледачких екстензија
- `6-space-game/README.md` - Razvoj igre bazirane na Canvas-u - `6-space-game/README.md` - Canvas заснована игра
- `9-chat-project/README.md` - AI chat asistent projekat - `9-chat-project/README.md` - AI асистент за ћаскање
### Struktura monorepozitorijuma ### Структура монорепозиторијума
Iako nije tradicionalni monorepo, ovaj repozitorijum sadrži više nezavisnih projekata: Иако није традиционални монорепозиторијум, овај репозиторијум садржи више независних пројеката:
- Svaka lekcija je samostalna - Свaka лекција је самостална
- Projekti ne dele zavisnosti - Пројекти не деле зависности
- Radite na pojedinačnim projektima bez uticaja na ostale - Радите на појединачним пројектима без утицаја на остале
- Klonirajte ceo repozitorijum za potpuno iskustvo kurikuluma - Клонирајте цео репозиторијум за пуну курикулумску комплетност
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Одрицање**: **Одрицање од одговорности**:
Овај документ је превео вештачки преводилац [Co-op Translator](https://github.com/Azure/co-op-translator). Иако тежимо прецизности, имајте у виду да аутоматски преводи могу садржати грешке или нетачности. Оригинални документ на његовом матерњем језику треба сматрати ауторитетним извором. За критичне информације препоручује се професионални људски превод. Нисмо одговорни за било какве неспоразуме или погрешне тумачења настала употребом овог превода. Овај документ је преведен коришћењем услуге за машински превод [Co-op Translator](https://github.com/Azure/co-op-translator). Иако се трудимо да превод буде прецизан, молимо вас да имате у виду да аутоматски преводи могу садржати грешке или нетачности. Оригинални документ на његовом изворном језику треба сматрати ауторитетом. За критичне информације препоручује се професионални превод који изводи стручни преводилац. Нисмо одговорни за било какве неспоразуме или погрешне тумачења која могу настати коришћењем овог превода.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->
Loading…
Cancel
Save