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

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

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"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",
"language_code": "hr"
},

@ -2,27 +2,27 @@
## 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
- **Edukativni 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
- **Interaktivni kvizovi**: 48 kvizova sa po 3 pitanja (evaluacije prije i poslije lekcija)
- **Podrška za više jezika**: Automatizirani prijevodi za 50+ jezika putem GitHub Actions
- **Nastavni 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, Code Editor i AI Chat asistent
- **Interaktivni kvizovi**: 48 kvizova sa po 3 pitanja svaki (procjena prije i nakon lekcije)
- **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)
### Arhitektura
- Edukacijski repozitorij s lekcijskom strukturom
- Edukativni repozitorij sa strukturom baziranom na lekcijama
- Svaka mapa lekcije sadrži README, primjere koda i rješenja
- Samostalni projekti u zasebnim direktorijima (quiz-app, razni projekti lekcija)
- Sustav prijevoda koristeći GitHub Actions (co-op-translator)
- Dokumentacija dostupna preko Docsify i kao PDF
- Samostalni projekti u posebnim direktorijima (quiz-app, razni projektni lekcijski direktoriji)
- Sustav prevođenja pomoću GitHub Actions (co-op-translator)
- Dokumentacija poslužena putem Docsify i dostupna kao PDF
## 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
@ -41,22 +41,22 @@ npm run build # Izgradi za produkciju
npm run lint # Pokreni ESLint
```
### Bankovni projekt API (Node.js + Express)
### Bankarski projekt API (Node.js + Express)
```bash
cd 7-bank-project/api
npm install
npm start # Pokreni API server
npm start # Pokreni API poslužitelj
npm run lint # Pokreni ESLint
npm run format # Formatiraj s Prettierom
```
### Projekti ekstenzija 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 ekstenzija specifičnih za preglednik
```
### Projekti svemirske igre
@ -72,35 +72,35 @@ npm install
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# Postavi GITHUB_TOKEN varijablu okoline
# Postavi varijablu okoline GITHUB_TOKEN
python api.py
```
## Radni tijek razvoja
## Razvojni tijek rada
### Za suradnike na sadržaju
1. **Forkajte repozitorij** na svoj GitHub račun
2. **Klonirajte svoj fork** lokalno
3. **Napravite novu granu** za svoje promjene
4. Izmijenite sadržaj lekcija ili primjere koda
5. Testirajte promjene koda u relevantnim direktorijima projekata
6. Pošaljite pull requestove prateći smjernice za doprinos
4. Izvršite promjene u sadržaju lekcija ili primjerima koda
5. Testirajte sve izmjene koda u odgovarajućim projektnim direktorijima
6. Pošaljite pull requestove u skladu s uputama za doprinose
### Za učenike
1. Forkajte ili klonirajte repozitorij
2. Redom prolazite kroz direktorije lekcija
2. Navigirajte kroz direktorije lekcija redom
3. Čitajte README datoteke za svaku lekciju
4. Riješite pred-lezijske kvizove na https://ff-quizzes.netlify.app/web/
5. Prođite primjere koda u mapama lekcija
6. Ispratite zadatke i izazove
7. Odgovorite na post-lezijske kvizove
4. Završite kvizove prije lekcija na https://ff-quizzes.netlify.app/web/
5. Riješite primjere koda u mapama lekcija
6. Završite zadatke i izazove
7. Polažite kvizove nakon lekcija
### Aktivni razvoj
### Živi razvoj
- **Dokumentacija**: Pokrenite `docsify serve` u korijenu (port 3000)
- **Quiz App**: Pokrenite `npm run dev` u direktoriju quiz-app
- **Dokumentacija**: Pokrenite `docsify serve` u rootu (port 3000)
- **Quiz aplikacija**: Pokrenite `npm run dev` u direktoriju quiz-app
- **Projekti**: Koristite VS Code Live Server ekstenziju za HTML projekte
- **API projekti**: Pokrenite `npm start` u odgovarajućim API direktorijima
@ -110,87 +110,87 @@ python api.py
```bash
cd quiz-app
npm run lint # Provjerite ima li problema sa stilom koda
npm run build # Provjerite je li izgradnja uspješna
npm run lint # Provjeri probleme sa stilom koda
npm run build # Provjeri uspješnost izgradnje
```
### Testiranje Bank API-ja
```bash
cd 7-bank-project/api
npm run lint # Provjerite probleme sa stilom koda
node server.js # Provjerite pokreće li se server bez pogrešaka
npm run lint # Provjeri probleme sa stilom koda
node server.js # Provjeri da li se poslužitelj pokreće bez grešaka
```
### 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:
- Primjere koda koji se izvršavaju bez grešaka
- Ispravnost linkova u dokumentaciji
- Uspješno dovršen build projekata
- Primjere u skladu s najboljim praksama
- Primjere koda koji se izvršavaju bez pogrešaka
- Ispravno funkcioniranje linkova u dokumentaciji
- Uspješnu gradnju projekata
- Slijedjenje najboljih praksi u primjerima
### 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 da prijevodi održavaju pravilnu strukturu
## Smjernice za stil koda
## Smjernice za stil kodiranja
### JavaScript
- Koristite modernu ES6+ sintaksu
- Pridržavajte se standardnih ESLint konfiguracija u projektima
- Koristite značenjem bogate nazive varijabli i funkcija za edukativnu jasnoću
- Dodajte komentare koji objašnjavaju koncepte za učenike
- Formatirajte kod pomoću Prettiera gdje je konfigurirano
- Slijedite standardne ESLint konfiguracije iz projekata
- Koristite smisleno imenovanje varijabli i funkcija radi jasnoće za učenike
- Dodajte komentare koji objašnjavaju koncepte
- Formatirajte kod koristeći Prettier gdje je konfigurirano
### HTML/CSS
- Semantički HTML5 elementi
- Principi responzivnog dizajna
- Jasan sustav imenovanja klasa
- Komentari koji pojašnjavaju CSS tehnike za učenike
- Jasne konvencije imenovanja klasa
- Komentari koji objašnjavaju CSS tehnike za učenike
### Python
- Slijedite PEP 8 stil
- Pridržavajte se PEP 8 smjernica
- Jasni, edukativni primjeri koda
- Tipizacija gdje pomaže za učenje
- Tipizacije tamo gdje pomažu učenju
### Markdown dokumentacija
- Jasna hijerarhija naslova
- Blokovi koda s označenim jezikom
- Code blokovi s označenim jezikom
- Linkovi na dodatne resurse
- Screenshoti i slike u mapama `images/`
- Alt tekst za slike radi pristupačnosti
### Organizacija datoteka
- Lekcije numerirane uzlazno (1-getting-started-lessons, 2-js-basics itd.)
- Svaki projekt sadrži `solution/` i često `start/` ili `your-work/` mape
- Slike pohranjene u mapama `images/` specifičnim za lekciju
- Lekcije numerirane sekvencijalno (1-getting-started-lessons, 2-js-basics, itd.)
- Svaki projekt ima direktorije `solution/` i često `start/` ili `your-work/`
- Slike se nalaze u lekcijski specifičnim mapama `images/`
- 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
cd quiz-app
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:
- **Lokacija aplikacije**: `/quiz-app`
- **Izlazna mapa**: `dist`
- **Lokacija izlaza**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Generiranje PDF dokumentacije
@ -200,26 +200,26 @@ npm install # Instalirajte docsify-to-pdf
npm run convert # Generirajte PDF iz docsa
```
### Docsify dokumentacija
### Dokumentacija Docsify
```bash
npm install -g docsify-cli # Globalno instalirajte Docsify
npm install -g docsify-cli # Instalirajte Docsify globalno
docsify serve # Poslužite na localhost:3000
```
### Svojstvene gradnje projekata
### Gradnje specifične za projekte
Svaki projekt može imati svoj proces izgradnje:
- Vue projekti: `npm run build` kreira produkcijske bundle
- Statički projekti: Nema izgradnje, datoteke se serviraju direktno
Svaki projektni direktorij može imati vlastiti proces gradnje:
- Vue projekti: `npm run build` kreira produkcijske bundleove
- Statički projekti: bez koraka gradnje, direktna usluga datoteka
## Smjernice za pull request
## Smjernice za pull requestove
### Format naslova
Koristite jasne, opisne naslove koji označavaju područje promjene:
- `[Quiz-app] Dodaj novi kviz za lekciju X`
- `[Lesson-3] Ispravi tipfeler u terrarium projektu`
- `[Lesson-3] Ispravi tipfelere u terrarium projektu`
- `[Translation] Dodaj španjolski prijevod za lekciju 5`
- `[Docs] Ažuriraj upute za postavljanje`
@ -228,55 +228,55 @@ Koristite jasne, opisne naslove koji označavaju područje promjene:
Prije slanja PR-a:
1. **Kvaliteta koda**:
- Pokrenite `npm run lint` u pogođenim direktorijima projekata
- Ispravite sve linting greške i upozorenja
- Pokrenite `npm run lint` u pogođenim projektnim direktorijima
- Ispravite sve lint greške i upozorenja
2. **Provjera builda**:
2. **Verifikacija gradnje**:
- 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
- Provjerite ispravnost referenci na slike
4. **Pregled sadržaja**:
- Le Korrekture pravopisa i gramatike
- Provjerite pravopis i gramatiku
- 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
- Prihvatite Microsoft CLA (automatska provjera kod prvog PR-a)
- Pridržavajte se [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Pogledajte [CONTRIBUTING.md](./CONTRIBUTING.md) za detaljne smjernice
- Uključite brojeve problema u opis PR-a ako je primjenjivo
- 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 upute
- U opisu PR-a navedite brojeve povezanih issuea ako ih ima
### Proces pregleda
- PR-ove pregledavaju održavatelji i zajednica
- Prioritet je edukativna jasnoća
- Primjeri koda trebaju slijediti aktualne najbolje prakse
- Prijevodi se pregledavaju zbog točnosti i kulturne prikladnosti
- Prioritet je jasnoća edukativnog sadržaja
- Primjeri koda trebaju slijediti trenutne najbolje prakse
- 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
- Automatski prevodi na 50+ jezika
- 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
1. Pronađite datoteku u `translations/{language-code}/`
2. Izvršite poboljšanja uz očuvanje strukture
3. Provjerite da primjeri koda ostaju funkcionalni
4. Testirajte lokalizirani sadržaj kvizova
2. Napravite poboljšanja pazeći na očuvanje strukture
3. Osigurajte ispravnost funkcionalnosti primjera koda
4. Testirajte eventualni lokalizirani sadržaj kvizova
### Metapodaci prijevoda
Prevedene datoteke sadrže zaglavlje metapodataka:
Prevedene datoteke sadrže metapodatkovni header:
```markdown
<!--
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
**Quiz aplikacija se ne pokreće**:
- Provjerite verziju Node.js (preporuka v14+)
- Obrišite `node_modules` i `package-lock.json`, pokrenite ponovno `npm install`
- Provjerite konflikte portova (zadano: Vite koristi port 5173)
**Quiz aplikacija ne želi startati**:
- Provjerite verziju Node.js (preporučeno v14+)
- Izbrišite `node_modules` i `package-lock.json`, pokrenite `npm install` ponovno
- Provjerite sukobe portova (default: Vite koristi port 5173)
**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
- Osigurajte da su sve ovisnosti instalirane s `npm install`
**Ekstenzija preglednika se ne učitava**:
- Provjerite je li manifest.json ispravno formatiran
**Proširenje za preglednik se ne učitava**:
- Provjerite ispravnost manifest.json formata
- 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**:
- Osigurajte da je paket OpenAI instaliran: `pip install openai`
- Provjerite je li postavljena varijabla okoline GITHUB_TOKEN
- Provjerite dozvole pristupa GitHub Models
**Problemi s Python chat projektom**:
- Provjerite je li instaliran paket OpenAI: `pip install openai`
- Provjerite je li GITHUB_TOKEN varijabla okruženja postavljena
- Provjerite dozvole pristupa za GitHub Models
**Docsify ne prikazuje dokumente**:
**Docsify ne poslužuje dokumente**:
- Instalirajte docsify-cli globalno: `npm install -g docsify-cli`
- Pokrenite iz korijena repozitorija
- Pokrenite iz root direktorija repozitorija
- Provjerite postoji li `docs/_sidebar.md`
### Savjeti za razvojno okruženje
- Koristite VS Code s Live Server ekstenzijom za HTML projekte
- Instalirajte ESLint i Prettier ekstenzije za dosljedno formatiranje
- Koristite DevTools preglednika za debugiranje JavaScript-a
- Za Vue projekte instalirajte Vue DevTools ekstenziju preglednika
- Koristite DevTools u pregledniku za debug JavaScripta
- 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`
- Izuzmite prijevode iz pretraživanja prilikom rada na engleskom sadržaju
- Procesi buildanja mogu biti spori pri prvom pokretanju (npm install, Vite build)
- Isključite prijevode iz pretraživanja kad radite na sadržaju na engleskom
- 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
- Koristite `.env` datoteke (već u `.gitignore`)
- Dokumentirajte potrebne varijable okoline u README-ima projekata
- API ključevi se nikad ne bi smjeli komitirati u repozitorij
- Koristite `.env` datoteke (već navedene u `.gitignore`)
- Dokumentirajte potrebne varijable okruženja u README-ima projekata
### Python projekti
- 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
### Pristup GitHub Models
- Za GitHub Models potrebni su Personal Access Tokeni (PAT)
- Tokeni se trebaju pohraniti kao varijable okoline
- Nikad ne komitirajte tokene ili pristupne podatke
- Potrebni su Personal Access Tokens (PAT) za GitHub modele
- Tokeni trebaju biti pohranjeni kao varijable okruženja
- Nikad nemojte komitirati tokene ili vjerodajnice
## Dodatne napomene
### Ciljana publika
- Potpuni početnici u web razvoju
- Studenti i samouki učenici
- Nastavnici koji koriste kurikulum u učionicama
- Sadržaj je dizajniran za pristupačnost i postupno izgrađivanje vještina
- Studenti i samostalni učenici
- Nastavnici koji koriste nastavne planove u učionicama
- 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)
- Praktične vježbe kodiranja
- Primjeri primjene u stvarnom svijetu
- Fokus na osnovama prije frameworka
- Primjeri iz stvarnog svijeta
- Fokus na temelje prije okvira
### Održavanje repozitorija
- Aktivna zajednica učenika i suradnika
- Redovna ažuriranja ovisnosti i sadržaja
- Problemi i diskusije nadzirani od strane održavatelja
- Ažuriranja prijevoda automatizirana putem GitHub Actions
- Redovne nadogradnje ovisnosti i sadržaja
- Problemi i diskusije praćeni od strane održavatelja
- Automatska ažuriranja prijevoda putem GitHub Actions
### Povezani resursi
- [Microsoft Learn moduli](https://docs.microsoft.com/learn/)
- [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
- Dodatni tečajevi: Generative AI, Data Science, ML, IoT kurikulumi dostupni
- Preporučen GitHub Copilot za učenike: [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot)
- 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:
- `quiz-app/README.md` - Vue 3 aplikacija kviza
- `7-bank-project/README.md` - Bankovna aplikacija s autentikacijom
- `5-browser-extension/README.md` - Razvoj ekstenzije za preglednik
- `6-space-game/README.md` - Razvoj igre koristeći Canvas
- `9-chat-project/README.md` - AI chat asistent projekt
- `7-bank-project/README.md` - Bankarska aplikacija s autentikacijom
- `5-browser-extension/README.md` - Razvoj proširenja za preglednik
- `6-space-game/README.md` - Razvoj igre bazirane na canvasu
- `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
- Projekti ne dijele ovisnosti
- Radite na pojedinim projektima bez utjecaja na druge
- Klonirajte cijeli repozitorij za kompletno iskustvo kurikuluma
- Rad na pojedinačnim projektima bez utjecaja na druge
- Klonirajte cijeli repozitorij za potpuno iskustvo nastavnog programa
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**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.
**Odricanje od odgovornosti**:
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 -->

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"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",
"language_code": "sl"
},

@ -2,29 +2,29 @@
## 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
- **Praktični projekti**: Terrarij, igra tipkanja, razširitev brskalnika, vesoljska igra, bančna aplikacija, urejevalnik kode in AI klepetalni asistent
- **Interaktivni kvizi**: 48 kvizov s po 3 vprašanji (pred in po lekciji)
- **Večjezična podpora**: Samodejni prevodi v več kot 50 jezikov preko GitHub Actions
- **Izobraževalna vsebina**: 24 strukturiranih lekcij, organiziranih v modulih na osnovi projektov
- **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 3 vprašanji vsak (pred in po lekciji)
- **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)
### Arhitektura
- Izobraževalni repozitorij z strukturo, osnovano na lekcijah
- Vsaka mapa lekcije vsebuje datoteko README, primerke kode in rešitve
- Samostojni projekti v ločenih imenikih (quiz-app, različni projektni lekcije)
- Sistem prevajanja z GitHub Actions (co-op-translator)
- Dokumentacija postrežena preko Docsify in na voljo kot PDF
- Učni skladišče z strukturo na osnovi lekcij
- Vsaka mapa lekcije vsebuje README, primere kode in rešitve
- Samostojni projekti v ločenih imenikih (quiz-app, različni lekcijski projekti)
- Sistem za prevajanje z uporabo GitHub Actions (co-op-translator)
- Dokumentacija, postrežena preko Docsify in dostopna kot PDF
## 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
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
@ -37,11 +37,11 @@ cd Web-Dev-For-Beginners
cd quiz-app
npm install
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
```
### Banka Projekt API (Node.js + Express)
### API projekta Banka (Node.js + Express)
```bash
cd 7-bank-project/api
@ -51,12 +51,12 @@ npm run lint # Zaženi ESLint
npm run format # Oblikuj s Prettierjem
```
### Projekti za razširitev brskalnika
### Projekti razširitev brskalnika
```bash
cd 5-browser-extension/solution
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
@ -67,7 +67,7 @@ npm install
# Odprite index.html v brskalniku ali uporabite Live Server
```
### Projekt Klepet (Python Backend)
### Projekt klepeta (Python Backend)
```bash
cd 9-chat-project/solution/backend/python
@ -76,33 +76,33 @@ pip install openai
python api.py
```
## Razvojni potek
## Razvojni potek dela
### Za prispevke k vsebini
### Za prispevatele vsebine
1. **Forkajte repozitorij** na svoj GitHub račun
2. **Klonirajte svoj fork** lokalno
3. **Ustvarite novo vejo** za svoje spremembe
4. Izvedite spremembe na vsebini lekcij ali primerih kode
5. Testirajte vse spremembe kode v ustreznih projektnih imenikih
6. Pošljite pull request po smernicah za prispevke
1. **Razvezi skladišče (fork)** v svoj GitHub račun
2. **Kloniraj svoj fork** lokalno
3. **Ustvari nov podal (branch)** za svoje spremembe
4. Naredi spremembe v vsebini lekcij ali primerih kode
5. Testiraj spremembe kode v ustreznih mapah projektov
6. Pošlji pull requeste v skladu z navodili za prispevanje
### Za učence
1. Forkajte ali klonirajte repozitorij
2. Postopoma obiščite mape lekcij
3. Preberite datoteke README za vsako lekcijo
4. Opravite pred-lekcijske kvize na https://ff-quizzes.netlify.app/web/
5. Delo z izvorno kodo v mapah lekcij
6. Opravite naloge in izzive
7. Opravite po-lekcijske kvize
1. Razvezi ali kloniraj skladišče
2. Pomakni se zaporedno skozi mape lekcij
3. Preberi README datoteke za vsako lekcijo
4. Reši predlečnične kvize na https://ff-quizzes.netlify.app/web/
5. Delaj skozi primere kode v mapah lekcij
6. Dokončaj naloge in izzive
7. Reši postlečnične kvize
### Živi razvoj
### Živ razvoj
- **Dokumentacija**: Zaženite `docsify serve` v korenski mapi (port 3000)
- **Quiz App**: Zaženite `npm run dev` v imeniku quiz-app
- **Projekti**: Uporabite razširitev VS Code Live Server za HTML projekte
- **API Projekti**: Zaženite `npm start` v ustreznih API imenikih
- **Dokumentacija**: Zaženi `docsify serve` v korenu projekta (port 3000)
- **Quiz App**: Zaženi `npm run dev` v mapi quiz-app
- **Projekti**: Uporabi razširitev VS Code Live Server za HTML projekte
- **API projekti**: Zaženi `npm start` v ustreznih API mapah
## Navodila za testiranje
@ -110,88 +110,88 @@ python api.py
```bash
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
```
### Testiranje Banka API
### Testiranje Bank API
```bash
cd 7-bank-project/api
npm run lint # Preverite težave s slogom kode
node server.js # Preverite, 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š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:
- Primerke kode tečejo brez napak
- Primeri kode tečejo brez napak
- Povezave v dokumentaciji delujejo pravilno
- Projekti se uspešno zgradijo
- Primeri sledijo najboljšim praksam
### Preverjanje pred oddajo
- Zaženite `npm run lint` v imenikih z package.json
- Preverite, da so povezave v markdownu veljavne
- Testirajte primere kode v brskalniku ali Node.js
- Preverite, da prevodi ohranjajo pravilno strukturo
- Zaženi `npm run lint` v mapah z datoteko package.json
- Preveri veljavnost povezav v markdownu
- Testiraj primere kode v brskalniku ali Node.js
- Preveri, da prevodi ohranjajo pravilno strukturo
## Smernice za stil kode
### JavaScript
- Uporabljajte sodobno sintakso ES6+
- Sledite standardnim konfiguracijam ESLint, ki so v projektih
- Upodobite razumljiva imena spremenljivk in funkcij za boljšo izobraževalno jasnost
- Dodajte komentarje za razlago konceptov za učence
- Uporabljajte Prettier kjer je konfiguriran
- Uporaba sodobne sintakse ES6+
- Sledenje standardnim ESLint konfiguracijam, podanim v projektih
- Uporaba pomenljivih imen spremenljivk in funkcij za lažje razumevanje
- Dodajanje komentarjev za pojasnitev konceptov za učence
- Formatiranje z uporabo Prettier kjer je konfigurirano
### HTML/CSS
- Semantični elementi HTML5
- Načela odzivne zasnove
- Jasna poimenovanja razredov
- Komentarji, ki pojasnjujejo tehnike CSS za učence
- Principi odzivnega oblikovanja
- Jasne konvencije poimenovanja razredov
- Komentarji, ki pojasnjujejo CSS tehnike za učence
### Python
- Smernice sloga PEP 8
- Slediti smernicam sloga PEP 8
- 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
- Bloki kode z označitvijo jezika
- Bloki kode z navedbo jezika
- Povezave do dodatnih virov
- Posnetki zaslona in slike v mapah `images/`
- Alt besedilo za slike za dostopnost
- Alt besedilo za slike zaradi dostopnosti
### 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/`
- Slike shranjene v lekcijsko-specifičnih mapah `images/`
- Slike so shranjene v lekcijsko specifičnih mapah `images/`
- Prevodi v strukturi `translations/{jezikovna-koda}/`
## Gradnja in namestitev
## Sestavljanje in nameščanje
### 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
cd quiz-app
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`
- **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
@ -204,79 +204,79 @@ npm run convert # Ustvari PDF iz docs
```bash
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:
- Vue projekti: `npm run build` ustvarja produkcijske pakete
- Statični projekti: brez gradnje, datoteke se postrežejo neposredno
Vsaka mapa projekta lahko ima lasten postopek gradnje:
- Vue projekti: `npm run build` ustvari produkcijske pakete
- Statični projekti: brez koraka gradnje, postreže se datoteke neposredno
## Smernice za pull requeste
### 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`
- `[Lesson-3] Popravi tipkarsko napako v projektu terrarij`
- `[Translation] Dodaja španski prevod za lekcijo 5`
- `[Docs] Posodobitev navodil za nastavitev`
- `[Lesson-3] Popravi tipkarsko napako v projektu terarij`
- `[Translation] Dodaj španski prevod za lekcijo 5`
- `[Docs] Posodobi navodila za nastavitev`
### Zahtevana preverjanja
### Zahtevani pregledi
Pred oddajo PR:
1. **Kakovost kode**:
- Zaženite `npm run lint` v prizadetih projektnih imenikih
- Popravite vse napake in opozorila linterja
- Zaženi `npm run lint` v prizadetih projektnih mapah
- Odpravi vse napake in opozorila linterja
2. **Preverjanje gradnje**:
- Zaženite `npm run build`, če je potrebno
- Zagotovite, da ni napak pri gradnji
- Zaženi `npm run build` če je potrebno
- Prepričaj se, da ni napak pri gradnji
3. **Preverjanje povezav**:
- Testirajte vse povezave v markdownu
- Preverite, da reference do slik delujejo
- Testiraj vse markdown povezave
- Preveri delovanje referenc slik
4. **Pregled vsebine**:
- Preverite pravopis in slovnico
- Prepričajte se, da so primeri kode pravilni in izobraževalni
- Preverite, da prevodi ohranjajo prvotni pomen
- Preveri pravopis in slovnico
- Zagotovi, da so primeri kode pravilni in poučni
- Preveri, da prevodi ohranjajo originalni pomen
### Zahteve za prispevek
### Zahteve za prispevanje
- Soglasje z Microsoft CLA (samodejno preverjanje ob prvem PR-ju)
- Sledite [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Ogled [CONTRIBUTING.md](./CONTRIBUTING.md) za podrobna navodila
- V opis PR vključite številke zadev, če je primerno
- Strinjanje z Microsoft CLA (avtomatizirana kontrola ob prvem PR)
- Sledenje [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Glej [CONTRIBUTING.md](./CONTRIBUTING.md) za podrobna navodila
- 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
- Primeri kode naj sledijo sodobnim najboljšim praksam
- Prevodi se pregledajo glede natančnosti in kulturne primernosti
- Primeri kode sledijo najboljšim trenutnim praksam
- 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
- Prevede v več kot 50 jezikov samodejno
- Izvorne datoteke v glavnih imenikih
- Prevedene datoteke v imenikih `translations/{jezikovna-koda}/`
- Samodejno prevaja v več kot 50 jezikov
- Izvorne datoteke so v glavnih direktorijih
- 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}/`
2. Izvedite izboljšave ob ohranjanju strukture
3. Poskrbite, da primeri kode ostanejo funkcionalni
4. Testirajte vsak lokalizirani kviz
1. Najdi datoteko v `translations/{jezikovna-koda}/`
2. Naredi izboljšave, ob ohranitvi strukture
3. Poskrbi, da primeri kode ostanejo funkcionalni
4. Testiraj lokalizirano vsebino kvizov
### Metapodatki prevoda
### Metapodatki prevodov
Prevedene datoteke vsebujejo glavo z metapodatki:
Prevedene datoteke vključujejo meta glavo:
```markdown
<!--
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
**Quiz app se ne zažene**:
- Preverite verzijo Node.js (priporočeno v14+)
- Izbrišite `node_modules` in `package-lock.json`, znova zaženite `npm install`
- Preverite konflikte porte (privzeto: Vite uporablja port 5173)
**Quiz app ne zažene**:
- Preveri verzijo Node.js (priporočena v14+)
- Izbriši `node_modules` in `package-lock.json`, ponovno zaženi `npm install`
- Preveri morebitne konflikte vrat (privzeto: Vite uporablja port 5173)
**API strežnik se ne zažene**:
- Preverite, da verzija Node.js ustreza minimalni zahtevani (node >=10)
- Preverite, ali je port že zaseden
- Preverite, da so vse odvisnosti nameščene z `npm install`
- Preveri verzijo Node.js (node >=10)
- Preveri, če je port že v uporabi
- Poskrbi, da so vse odvisnosti nameščene z `npm install`
**Razširitev brskalnika se ne naloži**:
- Preverite, da je manifest.json pravilno oblikovan
- Preverite konzolo brskalnika za napake
- Sledite navodilom za namestitev, specifičnim za brskalnik
- Preveri, da je manifest.json pravilno oblikovan
- Preveri konzolo brskalnika za napake
- Sledi navodilom za namestitev specifičnim za brskalnik
**Težave s Python klepetalnim projektom**:
- Poskrbite, da je paket OpenAI nameščen: `pip install openai`
- Preverite, da je okoljska spremenljivka GITHUB_TOKEN nastavljena
- Preverite dostopna dovoljenja za GitHub Models
**Težave s projektom klepeta v Pythonu**:
- Namesti paket OpenAI: `pip install openai`
- Preveri, da je okoljska spremenljivka GITHUB_TOKEN nastavljena
- Preveri dovoljenja za dostop do GitHub modelov
**Docsify ne postreže dokumentacije**:
- Namestite docsify-cli globalno: `npm install -g docsify-cli`
- Zaženite z korenske mape repozitorija
- Preverite, da datoteka `docs/_sidebar.md` obstaja
- Namesti docsify-cli globalno: `npm install -g docsify-cli`
- Zaženi v korenski mapi skladišča
- Preveri obstoj `docs/_sidebar.md`
### Nasveti za razvojno okolje
- Uporabljajte VS Code z razširitvijo Live Server za HTML projekte
- Namestite razširitve ESLint in Prettier za dosledno oblikovanje
- Uporabite orodja brskalnika za odpravljanje napak v JavaScriptu
- Za Vue projekte namestite Vue DevTools razširitev za brskalnik
- Uporabljaj VS Code z razširitvijo Live Server za HTML projekte
- Namesti razširitve ESLint in Prettier za skladno oblikovanje
- Uporabljaj DevTools brskalnika za razhroščevanje JavaScript-a
- 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
- Za delo samo z vsebino uporabite plitek klon: `git clone --depth 1`
- Izključite prevode iz iskanja, ko delate v angleški vsebini
- Procesi gradnje so lahko počasni pri prvem zagonu (npm install, Vite build)
- Veliko število prevedenih datotek (več kot 50 jezikov) pomeni velike polne klone
- Uporabi plitki klon, če delaš le na vsebini: `git clone --depth 1`
- Izključi prevode iz iskanj, ko delaš na angleški vsebini
- Procesi gradnje so lahko počasnejši ob prvem zagonu (npm install, Vite build)
## Varnostni vidiki
### Okoljske spremenljivke
- API ključi se nikoli ne smejo shranjevati v repozitorij
- Uporabljajte `.env` datoteke (že dodane v `.gitignore`)
- Dokumentirajte zahtevane okoljske spremenljivke v README-jih projektov
- Ključi API ne smejo biti nikoli vključeni v repozitorij
- Uporabljaj `.env` datoteke (že vključene v `.gitignore`)
- Dokumentiraj potrebne okoljske spremenljivke v README-jih projektov
### Python projekti
- Uporabljajte virtualna okolja: `python -m venv venv`
- Posodabljajte odvisnosti
- GitHub tokeni naj imajo minimalna potrebna dovoljenja
- Uporabljaj virtualna okolja: `python -m venv venv`
- Posodabljaj odvisnosti
- GitHub tokeni naj imajo minimalne potrebne pravice
### Dostop do GitHub Models
### Dostop do GitHub modelov
- Za GitHub Models so potrebni osebni dostopni žetoni (PAT)
- Ti žetoni naj se shranjujejo kot okoljske spremenljivke
- Žetonov ali poverilnic nikoli ne oddajajte v repozitorij
- Za GitHub modele so potrebni osebni dostopni tokeni (PAT)
- Tokeni morajo biti shranjeni kot okoljske spremenljivke
- Tokenov ali poverilnic nikoli ne vključi v repozitorij
## Dodatne opombe
### Ciljna publika
- Popolni začetniki v spletni razvoj
- Študenti in samostojni učenci
- Učitelji, ki uporabljajo kurikulum v razredih
- Vsebina je zasnovana za dostopnost in postopno nabiranje znanja
- Študenti in samouki
- Učitelji, ki uporabljajo učni načrt v razredih
- Vsebina je zasnovana za dostopnost in postopno gradnjo veščin
### Izobraževalna filozofija
- Pristop učenja na podlagi projektov
- Pristop učenja na osnovi projektov
- Pogoste preveritve znanja (kvizi)
- Praktične vaje kodiranja
- Primeri iz resničnega sveta
- Osredotočenost na osnove pred okvirji (frameworki)
- Praktične vaje programiranja
- Primeri uporabe iz realnega sveta
- 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
- Spremljanje zadev in razprav s strani vzdrževalcev
- Prevodi se posodabljajo samodejno preko GitHub Actions
- Vzdrževalci nadzorujejo težave in razprave
- Prevodi se posodabljajo avtomatsko preko GitHub Actions
### Povezani viri
### Sorodni viri
- [Microsoft Learn moduli](https://docs.microsoft.com/learn/)
- [Student Hub viri](https://docs.microsoft.com/learn/student-hub/)
- [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č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
Za podrobna navodila o posameznih projektih si oglejte datoteke README v:
- `quiz-app/README.md` - Vue 3 aplikacija za kvize
Za podrobna navodila o posameznih projektih glej README datoteke v:
- `quiz-app/README.md` - Vue 3 aplikacija kviza
- `7-bank-project/README.md` - Bančna aplikacija z avtentikacijo
- `5-browser-extension/README.md` - Razvoj razširitve brskalnika
- `6-space-game/README.md` - Razvoj igre na podlagi Canvas
- `9-chat-project/README.md` - Projekt AI klepetalnega asistenta
- `6-space-game/README.md` - Razvoj igre na platnu (Canvas)
- `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
- Projekti ne delijo odvisnosti
- Delajte na posameznih projektih brez vpliva na druge
- Klonite celoten repozitorij za popolno izkušnjo kurikuluma
- Delo na posameznih projektih brez vpliva na druge
- Kloniraj celotno skladišče za celotno učni izkušnjo
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**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 -->

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"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",
"language_code": "sr"
},

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