msb-public
/
Web-Dev-For-Beginners
mirror of https://github.com/microsoft/Web-Dev-For-Beginners.git
1
0
Code Issues Projects Releases Wiki Activity

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

Browse Source
pull/1774/head
localizeflow[bot] 6 months ago
parent 3be5a46118
commit b9f13b99b8
9 changed files with 1533 additions and 1539 deletions
Show Stats Download Patch File Download Diff File

6
translations/hr/.co-op-translator.json
Unescape View File

@ -1,7 +1,7 @@
{ {
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": { "1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8", "original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-06T15:06:23+00:00", "translation_date": "2026-03-27T23:32:42+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md", "source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "hr" "language_code": "hr"
}, },
@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T15:15:01+00:00", "translation_date": "2026-03-27T23:38:18+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "hr" "language_code": "hr"
}, },

624
translations/hr/1-getting-started-lessons/1-intro-to-programming-languages/README.md
View File

File diff suppressed because it is too large Load Diff

290
translations/hr/AGENTS.md
Unescape View File

@ -2,46 +2,46 @@
## Pregled projekta ## Pregled projekta
Ovo je repozitorij obrazovnog kurikuluma za podučavanje osnova web razvoja početnicima. Kurikulum je sveobuhvatan tečaj u trajanju od 12 tjedana, razvijen od strane Microsoft Cloud Advocates, sadrži 24 praktične lekcije koje pokrivaju JavaScript, CSS i HTML. Ovo je edukativni repozitorij za podučavanje temelja web razvoja početnicima. Kurikulum je obuhvatan tečaj u trajanju od 12 tjedana koji je razvijen od strane Microsoft Cloud Advocatesa, a sadrži 24 praktične lekcije pokrivajući JavaScript, CSS i HTML.
### Ključne komponente ### Ključne komponente
- **Obrazovni sadržaj**: 24 strukturirane lekcije organizirane u module temeljene na projektima - **Edukativni sadržaj**: 24 strukturirane lekcije organizirane u module temeljene na projektima
- **Praktični projekti**: Terrarij, igra tipkanja, proširenje preglednika, svemirska igra, bankarska aplikacija, uređivač koda i AI chat asistent - **Praktični projekti**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor i AI Chat Assistant
- **Interaktivni kvizovi**: 48 kvizova s po 3 pitanja (procjena prije/nakon lekcije) - **Interaktivni kvizovi**: 48 kvizova sa po 3 pitanja (prije/poslije lekcije)
- **Podrška za više jezika**: Automatski prijevodi za više od 50 jezika putem GitHub Actions - **Podrška za više jezika**: Automatski prijevodi za 50+ jezika 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
- Obrazovni repozitorij s lekcijsko-temeljnom strukturom - Edukativni repozitorij s organizacijom po 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 posebnim direktorijima (quiz-app, različiti projekti lekcija) - Samostalni projekti u zasebnim direktorijima (quiz-app, razni projekti lekcija)
- Sustav prijevoda koristeći GitHub Actions (co-op-translator) - Sustav za prijevod koristeći GitHub Actions (co-op-translator)
- Dokumentacija dostupna putem Docsify i kao PDF - Dokumentacija dostupna preko Docsify i kao PDF
## Komande za postavljanje ## Komande za postavljanje
Ovaj repozitorij je prvenstveno za konzumaciju obrazovnog sadržaja. Za rad sa specifičnim projektima: Ovaj repozitorij je prvenstveno namijenjen za konzumaciju edukativnog sadržaja. Za rad na specifičnim projektima:
### Postavljanje glavnog repozitorija ### Glavno postavljanje repozitorija
```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
``` ```
### Postavljanje Quiz aplikacije (Vue 3 + Vite) ### Postavljanje Quiz app (Vue 3 + Vite)
```bash ```bash
cd quiz-app cd quiz-app
npm install npm install
npm run dev # Pokreni razvojni poslužitelj npm run dev # Pokreni razvojni server
npm run build # Izgradi za produkciju npm run build # Izgradi za produkciju
npm run lint # Pokreni ESLint npm run lint # Pokreni ESLint
``` ```
### Bankarski projekt API (Node.js + Express) ### Bank Project API (Node.js + Express)
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
@ -51,15 +51,15 @@ npm run lint # Pokreni ESLint
npm run format # Formatiraj s Prettierom npm run format # Formatiraj s Prettierom
``` ```
### Projekti proširenja preglednika ### Projekti browser ekstenzija
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
npm install npm install
# Slijedite upute za učitavanje proširenja specifična za preglednik # Slijedite upute za učitavanje proširenja specifične za preglednik
``` ```
### Projekti svemirske igre ### Projekti Space game
```bash ```bash
cd 6-space-game/solution cd 6-space-game/solution
@ -76,77 +76,77 @@ pip install openai
python api.py python api.py
``` ```
## Radni tok 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. **Kreirajte novu granu** za svoje izmjene 3. **Napravite novu granu** za svoje promjene
4. Napravite izmjene u sadržaju lekcija ili primjerima koda 4. Izvršite izmjene u sadržaju lekcija ili primjerima koda
5. Testirajte izmjene koda u odgovarajućim direktorijima projekata 5. Testirajte promjene koda u relevantnim direktorijima projekata
6. Pošaljite pull requestove prema smjernicama za doprinos 6. Podnesite pull request slijedeći smjernice za doprinos
### Za učenike ### Za učenike
1. Forkajte ili klonirajte repozitorij 1. Forkajte ili klonirajte repozitorij
2. Prolazite kroz direktorije lekcija redom 2. Krenite redom kroz mape lekcija
3. Čitajte README datoteke za svaku lekciju 3. Pročitajte README datoteke za svaku lekciju
4. Riješite pred-lekcijske kvizove na https://ff-quizzes.netlify.app/web/ 4. Riješite kvizove prije lekcije na https://ff-quizzes.netlify.app/web/
5. Radite kroz primjere koda u mapama lekcija 5. Prođite kroz primjere koda u mapama lekcija
6. Dovršite zadatke i izazove 6. Završite zadatke i izazove
7. Riješite post-lekcijske kvizove 7. Riješite kvizove nakon lekcije
### Razvoj uživo ### Razvoj u stvarnom vremenu
- **Dokumentacija**: Pokrenite `docsify serve` u korijenu (port 3000) - **Dokumentacija**: Pokrenite `docsify serve` u root direktoriju (port 3000)
- **Quiz aplikacija**: Pokrenite `npm run dev` u direktoriju quiz-app - **Quiz App**: Pokrenite `npm run dev` u quiz-app direktoriju
- **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
## Upute za testiranje ## Upute za testiranje
### Testiranje Quiz aplikacije ### Testiranje Quiz app
```bash ```bash
cd quiz-app cd quiz-app
npm run lint # Provjerite probleme sa stilom koda npm run lint # Provjerite ima li problema sa stilom koda
npm run build # Provjerite uspjeh izgradnje npm run build # Provjerite je li izgradnja uspješna
``` ```
### Testiranje Bank API-ja ### Testiranje Bank API
```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 poslužitelj bez pogrešaka node server.js # Provjeri da li se server pokreće bez grešaka
``` ```
### Općeniti pristup testiranju ### Opći pristup testiranju
- Ovo je obrazovni repozitorij bez sveobuhvatnih automatiziranih testova - Ovo je edukativni repozitorij bez potpune automatizirane testne pokrivenosti
- Ručno testiranje se fokusira na: - Ručno testiranje fokusira se na:
- Primjere koda koji rade bez pogrešaka - Primjere koda da se izvršavaju bez grešaka
- Ispravnost poveznica u dokumentaciji - Da linkovi u dokumentaciji rade ispravno
- Uspješan završetak gradnje projekata - Da se projekti mogu uspješno buildati
- Primjere koji slijede najbolje prakse - Primjere koji slijede najbolje prakse
### Provjere prije predaje ### Provjere prije podnošenja
- Pokrenite `npm run lint` u direktorijima s package.json - Pokrenite `npm run lint` u direktorijima s package.json
- Provjerite valjanost markdown poveznica - 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 pravilnu strukturu - Provjerite održavanje strukture u prijevodima
## Smjernice za stil koda ## Smjernice za stil kodiranja
### JavaScript ### JavaScript
- Koristite modernu ES6+ sintaksu - Koristite modernu ES6+ sintaksu
- Slijedite standardne ESLint konfiguracije zadane u projektima - Slijedite standardne ESLint konfiguracije iz projekata
- Koristite smislen pripad imena varijabla i funkcija radi obrazovne jasnoće - Koristite smisleno imenovanje varijabli i funkcija radi bolje edukativne jasnoće
- Dodajte komentare koji objašnjavaju koncepte za učenike - Dodajte komentare koji objašnjavaju koncepte za učenike
- Formatirajte pomoću Prettier gdje je konfigurirano - Formatirajte kod koristeći Prettier gdje je konfigurirano
### HTML/CSS ### HTML/CSS
@ -157,47 +157,47 @@ node server.js # Provjerite pokreće li se poslužitelj bez pogrešaka
### Python ### Python
- Smjernice stilskog vodiča PEP 8 - Smjernice za stil PEP 8
- Jasni, obrazovni primjeri koda - Jasni, edukativni primjeri koda
- Tipovi (type hints) gdje pomažu u učenju - Tipizacija tamo gdje je korisna za učenje
### Markdown dokumentacija ### Markdown dokumentacija
- Jasna hijerarhija naslova - Jasna hijerarhija naslova
- Blokovi koda s označenim jezikom - Blokovi koda s označenim jezikom
- Poveznice na dodatne resurse - Linkovi na dodatne izvore
- Snimke zaslona i slike u direktorijima `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 uzastopno (1-getting-started-lessons, 2-js-basics itd.) - Lekcije numerirane sekvencijalno (1-getting-started-lessons, 2-js-basics, itd.)
- Svaki projekt ima `solution/` i često `start/` ili `your-work/` direktorije - Svaki projekt ima mape `solution/` i često `start/` ili `your-work/`
- Slike pohranjene u lekcijskim `images/` mapama - Slike pohranjene u lekcijski specifičnim mapama `images/`
- Prijevodi u strukturi `translations/{language-code}/` - Prijevodi u strukturi `translations/{language-code}/`
## Izgradnja i postavljanje ## Izrada i deploy
### Postavljanje Quiz aplikacije (Azure Static Web Apps) ### Deploy Quiz app (Azure Static Web Apps)
quiz-app je konfiguriran za Azure Static Web Apps: quiz-app je podešen za Azure Static Web Apps deployment:
```bash ```bash
cd quiz-app cd quiz-app
npm run build # Stvara mapu dist/ npm run build # Stvara mapu dist/
# Objavljuje putem GitHub Actions tijeka rada pri pushu na main # Postavlja putem GitHub Actions tijeka rada pri pushanju na main
``` ```
Konfiguracija Azure Static Web Apps: Konfiguracija Azure Static Web Apps:
- **Lokacija aplikacije**: `/quiz-app` - **Lokacija aplikacije**: `/quiz-app`
- **Izlazna lokacija**: `dist` - **Lokacija izlaza**: `dist`
- **Radni tijek**: `.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
```bash ```bash
npm install # Instalirajte docsify-to-pdf npm install # Instalirajte docsify-to-pdf
npm run convert # Generirajte PDF iz docsa npm run convert # Generiraj PDF iz docsa
``` ```
### Docsify dokumentacija ### Docsify dokumentacija
@ -207,72 +207,72 @@ npm install -g docsify-cli # Instalirajte Docsify globalno
docsify serve # Poslužite na localhost:3000 docsify serve # Poslužite na localhost:3000
``` ```
### Izgradnja specifičnih projekata ### Build specifični za projekte
Svaki direktorij projekta može imati vlastiti proces izgradnje: Svaki direktorij projekta može imati svoj build proces:
- Vue projekti: `npm run build` za proizvodne pakete - Vue projekti: `npm run build` kreira produkcijske bundleove
- Statički projekti: Nema koraka izgradnje, posluživanje datoteka direktno - Statički projekti: Nema build koraka, služenje datoteka direktno
## Smjernice za pull requestove ## 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 izmjene:
- `[Quiz-app] Dodaj novi kviz za lekciju X` - `[Quiz-app] Dodaj novi kviz za lekciju X`
- `[Lesson-3] Ispravi tipografsku pogrešku 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`
### Obavezne provjere ### Potrebne provjere
Prije slanja PR-a: Prije podnošenja PR-a:
1. **Kvaliteta koda**: 1. **Kvaliteta koda**:
- Pokrenite `npm run lint` u zahvaćenim projektima - Pokrenite `npm run lint` u pogođenim projekt direktorijima
- Ispravite sve lint pogreške i upozorenja - Ispravite sve lint greške i upozorenja
2. **Provjera gradnje**: 2. **Provjera builda**:
- Pokrenite `npm run build` ako je primjenjivo - Pokrenite `npm run build` ako je primjenjivo
- Osigurajte da nema grešaka u gradnji - Osigurajte da nema build grešaka
3. **Provjera poveznica**: 3. **Provjera linkova**:
- Testirajte sve markdown poveznice - Testirajte sve markdown linkove
- Provjerite referencirane slike - Provjerite da reference na slike rade
4. **Pregled sadržaja**: 4. **Pregled sadržaja**:
- Provjerite pravopis i gramatiku - Provjerite pravopis i gramatiku
- Osigurajte da su primjeri koda ispravni i obrazovni - Potvrdite da su primjeri koda točni i edukativni
- Provjerite da prijevodi zadržavaju izvorno značenje - Osigurajte da prijevodi zadržavaju izvornu poruku
### Zahtjevi za doprinos ### Zahtjevi za doprinos
- Slažete se s Microsoft CLA (automatska provjera pri prvom PR-u) - Prihvatite Microsoft CLA (automatska provjera pri prvom PR-u)
- Slijedite [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 smjernice
- Referencirajte broj/e problema u opisu PR-a ako je primjenjivo - Referencirajte brojeve issue-a u opisu PR-a ako je primjenjivo
### Proces pregleda ### Proces pregleda
- PR-ove pregledavaju održavatelji i zajednica - PR-ove pregledavaju maintaineri i zajednica
- Prioritet je obrazovna jasnoća - Prioritet je edukativna jasnoća
- Primjeri koda trebaju slijediti aktualne najbolje prakse - Primjeri koda trebaju slijediti aktualne najbolje prakse
- Prijevodi se pregledavaju na točnost i kulturnu prikladnost - Prijevodi se pregledavaju radi točnosti i prikladnosti kulture
## Sustav prijevoda ## Sustav prijevoda
### Automatski prijevod ### Automatski prijevod
- Koristi GitHub Actions s co-op-translator workflow - Koristi GitHub Actions s co-op-translator workflowom
- Automatski prevodi na više od 50 jezika - Automatski prevodi na 50+ jezika
- Izvorne datoteke u glavnim direktorijima - Izvorne datoteke u glavnim direktorijima
- Prevedene datoteke u `translations/{language-code}/` direktorijima - Prevedene datoteke u mapama `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. Unesite poboljšanja dok održavate strukturu 2. Napravite poboljšanja dok čuvate strukturu
3. Osigurajte da primjeri koda ostanu funkcionalni 3. Osigurajte da primjeri koda ostaju funkcionalni
4. Testirajte sve lokalizirane kviz sadržaje 4. Testirajte lokalizirani kviz sadržaj
### Metapodaci prijevoda ### Metapodaci prijevoda
@ -291,90 +291,90 @@ CO_OP_TRANSLATOR_METADATA:
## Otklanjanje pogrešaka i rješavanje problema ## Otklanjanje pogrešaka i rješavanje problema
### Česti problemi ### Uobičajeni problemi
**Quiz aplikacija se ne pokreće**: **Quiz app se ne pokreće**:
- Provjerite verziju Node.js (preporučeno v14+) - Provjerite verziju Node.js (preporučeno v14+)
- Obrišite `node_modules` i `package-lock.json`, ponovno pokrenite `npm install` - Izbrišite `node_modules` i `package-lock.json`, zatim pokrenite `npm install` ponovno
- Provjerite sukobe porta (zadano: Vite koristi port 5173) - Provjerite konflikt porta (default: Vite koristi port 5173)
**API server se ne pokreće**: **API server se ne pokreće**:
- Provjerite da je verzija Node.js zadovoljavajuća (node >=10) - Provjerite je li verzija Node.js minimalno node >=10
- Provjerite koristi li port drugi proces - Provjerite koristi li neko drugi već port
- Osigurajte instalirane sve ovisnosti s `npm install` - Osigurajte da su sve ovisnosti instalirane s `npm install`
**Proširenje preglednika se ne učitava**: **Browser ekstenzija se ne učitava**:
- Provjerite ispravnost formata manifest.json - Provjerite da je manifest.json pravilno formatiran
- Pregledajte konzolu preglednika zbog pogrešaka - Provjerite konzolu preglednika radi grešaka
- Slijedite upute za instalaciju specifične za preglednik - Slijedite upute za instalaciju specifične za preglednik
**Problemi s Python chat projektom**: **Problemi s Python chat projektom**:
- Osigurajte instaliran OpenAI paket: `pip install openai` - Provjerite je li instaliran OpenAI paket: `pip install openai`
- Provjerite je li varijabla okoliša GITHUB_TOKEN postavljena - Provjerite je li varijabla okoline GITHUB_TOKEN postavljena
- Provjerite dozvole za pristup GitHub Models - Provjerite pristupni token za GitHub modele
**Docsify ne poslužuje dokumente**: **Docsify ne prikazuje dokumentaciju**:
- Globalno instalirajte docsify-cli: `npm install -g docsify-cli` - Instalirajte docsify-cli globalno: `npm install -g docsify-cli`
- Pokrenite iz korijenskog direktorija repozitorija - Pokrenite iz root direktorija repozitorija
- Provjerite postojanje `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 konzistentno formatiranje
- Koristite DevTools preglednika za otklanjanje JavaScript pogrešaka - Koristite browser DevTools za debugiranje JavaScript-a
- Za Vue projekte instalirajte Vue DevTools ekstenziju preglednika - Za Vue projekte instalirajte Vue DevTools ekstenziju u preglednik
### Razmatranja performansi ### Razmatranja performansi
- Veliki broj prevedenih datoteka (50+ jezika) znači da su puni klonovi veliki - Velik broj prevedenih datoteka (50+ jezika) znači velike full clone-ove
- 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`
- Isključite prijevode iz pretraživanja pri radu na engleskom - Isključite prijevode iz pretraživanja kada radite na engleskom sadržaju
- Procesi gradnje mogu biti spori pri prvom pokretanju (npm install, Vite build) - Build procesi mogu biti spori pri prvom pokretanju (npm install, Vite build)
## Sigurnosne napomene ## Sigurnosne napomene
### Varijable okoliša ### Okolišne varijable
- API ključevi nikada ne smiju biti spremljeni u repozitorij - API ključevi nikada ne smiju biti komitirani u repozitorij
- Koristite `.env` datoteke (već u `.gitignore`) - Koristite `.env` datoteke (već u `.gitignore`)
- Dokumentirajte potrebne varijable okoliša u README datotekama projekata - Dokumentirajte potrebne okolišne varijable u README-ima projekata
### Python projekti ### Python projekti
- Koristite virtualne okoline: `python -m venv venv` - Koristite virtualna okruženja: `python -m venv venv`
- Održavajte ovisnosti ažuriranima - Održavajte ovisnosti ažurnima
- GitHub tokeni trebaju imati minimalne potrebne dozvole - GitHub tokeni trebaju imati minimalna potrebna dopuštenja
### Pristup GitHub Models ### Pristup GitHub modelima
- Potrebni su Personal Access Tokens (PAT) za GitHub Models - Potrebni su Personal Access Tokens (PAT) za GitHub modele
- Tokeni trebaju biti pohranjeni kao varijable okoliša - Tokene treba čuvati kao okolišne varijable
- Nikada ne committajte tokene ili vjerodajnice - Nikada nemojte komitirati tokene ili pristupne podatke
## Dodatne napomene ## Dodatne napomene
### Ciljana publika ### Ciljana publika
- Potpuni početnici u web razvoju - Potpuni početnici u web razvoju
- Učenici i samouki - Studenti i samouki učenici
- Nastavnici koji koriste kurikulum u učionicama - Nastavnici koji koriste kurikulum u učionicama
- Sadržaj je dizajniran za pristupačnost i postupno usvajanje vještina - Sadržaj je dizajniran za pristupačnost i postupno usvajanje vještina
### Obrazovna filozofija ### Edukativna filozofija
- Pristup učenja temeljen na projektima - Pristup temeljen na projektima
- Česte provjere znanja (kvizovi) - Česti provjeri znanja (kvizovi)
- Praktične vježbe kodiranja - Praktične vježbe kodiranja
- Primjeri iz stvarnog svijeta - Primjeri primjene u stvarnom svijetu
- Fokus na osnove prije frameworka - Fokus na temelje prije frameworka
### Održavanje repozitorija ### Održavanje repozitorija
- Aktivna zajednica učenika i suradnika - Aktivna zajednica učenika i suradnika
- Redovita ažuriranja ovisnosti i sadržaja - Redovita ažuriranja ovisnosti i sadržaja
- Problemi i diskusije pregledavani od strane održavatelja - Pratiti issue-e i diskusije maintaineri
- Automatska ažuriranja prijevoda putem GitHub Actions - Ažuriranja prijevoda automatizirana preko GitHub Actions
### Povezani resursi ### Povezani resursi
@ -385,24 +385,24 @@ CO_OP_TRANSLATOR_METADATA:
### Rad sa specifičnim projektima ### Rad sa specifičnim projektima
Za detaljne upute o pojedinim projektima, pogledajte README datoteke u: Za detaljne upute o pojedinačnim projektima, pogledajte README datoteke u:
- `quiz-app/README.md` - Vue 3 aplikacija za kvizove - `quiz-app/README.md` - Vue 3 aplikacija za kviz
- `7-bank-project/README.md` - Bankarska aplikacija s autentifikacijom - `7-bank-project/README.md` - Bankarska aplikacija s autentifikacijom
- `5-browser-extension/README.md` - Razvoj proširenja preglednika - `5-browser-extension/README.md` - Razvoj browser ekstenzije
- `6-space-game/README.md` - Razvoj igre u Canvasu - `6-space-game/README.md` - Razvoj igre u canvasu
- `9-chat-project/README.md` - AI chat asistent projekt - `9-chat-project/README.md` - Projekt AI chat asistenta
### Struktura monorepa ### Struktura Monorepo-a
Iako nije tradicionalni monorepo, ovaj repozitorij sadrži više neovisnih projekata: Iako nije tradicionalni monorepo, ovaj repozitorij sadrži više neovisnih projekata:
- Svaka lekcija je samostalna - Svaka lekcija je samostalna cjelina
- Projekti ne dijele ovisnosti - Projekti ne dijele ovisnosti
- Radite na pojedinim projektima bez utjecaja na druge - Radite pojedinačno na projektima bez utjecaja na druge
- Klonirajte cijeli repozitorij za cjelokupni kurikulum iskustvo - Klonirajte cijeli repozitorij za potpuni kurikulum iskustvo
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Odricanje od odgovornosti**: **Odricanje**:
Ovaj dokument je preveden korištenjem AI usluge prevođenja [Co-op Translator](https://github.com/Azure/co-op-translator). Iako težimo točnosti, imajte na umu da automatski prijevodi mogu sadržavati pogreške ili netočnosti. Izvorni dokument na njegovom izvornom jeziku treba smatrati službenim i autoritativnim izvorom. Za važne informacije preporučuje se profesionalni prijevod čovjeka. Ne snosimo odgovornost za bilo kakve nesporazume ili kriva tumačenja koja proizlaze iz korištenja ovog prijevoda. Ovaj dokument preveden je pomoću AI prevoditeljskog servisa [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 izvornom jeziku smatra se službenim izvorom. Za kritične informacije preporučuje se profesionalni ljudski prijevod. Ne snosimo odgovornost za bilo kakve nesporazume ili pogrešna tumačenja proizašla iz korištenja ovog prijevoda.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->

6
translations/sl/.co-op-translator.json
Unescape View File

@ -1,7 +1,7 @@
{ {
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": { "1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8", "original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-06T15:12:27+00:00", "translation_date": "2026-03-27T23:36:11+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md", "source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "sl" "language_code": "sl"
}, },
@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T15:16:09+00:00", "translation_date": "2026-03-27T23:39:15+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "sl" "language_code": "sl"
}, },

686
translations/sl/1-getting-started-lessons/1-intro-to-programming-languages/README.md
View File

File diff suppressed because it is too large Load Diff

290
translations/sl/AGENTS.md
Unescape View File

@ -2,29 +2,29 @@
## Pregled projekta ## Pregled projekta
To je učni učni načrt za poučevanje osnov razvoja spletnih strani 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, ki pokrivajo JavaScript, CSS in HTML. To je repozitorij izobraževalnega učnega načrta 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, ki pokrivajo JavaScript, CSS in HTML.
### Ključne sestavine ### Ključne sestavine
- **Izobraževalna vsebina**: 24 strukturiranih lekcij, organiziranih v module na osnovi projektov - **Izobraževalna vsebina**: 24 strukturiranih lekcij, organiziranih v module, ki temeljijo na projektih
- **Praktični projekti**: Terrarium, Tipkovniška igra, Razširitev brskalnika, Vesoljska igra, Bančniški pripomoček, Urejevalnik kode in AI klepetalni pomočnik - **Praktični projekti**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor in AI Chat Assistant
- **Interaktivni kvizi**: 48 kvizov s po 3 vprašanji (ocenjevanje pred/nad lekcijo) - **Interaktivni kvizi**: 48 kvizov s po 3 vprašanji (ocenjevanje pred/potem lekcije)
- **Podpora več jezikom**: Avtomatski prevodi za več kot 50 jezikov prek GitHub Actions - **Večjezična podpora**: 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ževalno skladišče z strukturo po lekcijah - Izobraževalni repozitorij z strukturo, ki temelji na lekcijah
- Vsaka mapa lekcije vsebuje README, primere 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 lekciji) - Samostojni projekti v ločenih imenikih (quiz-app, različni lekcijski projekti)
- Sistem prevajanja z GitHub Actions (co-op-translator) - Sistem prevajanja, ki uporablja GitHub Actions (co-op-translator)
- Dokumentacija dostopna prek Docsify in kot PDF - Dokumentacija je dostopna preko Docsify in na voljo kot PDF
## Ukazi za nastavitev ## Ukazi za nastavitev
To skladišče je primarno namenjeno za uporabo izobraževalne vsebine. Za delo s specifičnimi projekti: Ta repozitorij je namenjen predvsem za uporabo izobraževalne vsebine. Za delo s specifičnimi projekti:
### Nastavitev glavnega skladišča ### Nastavitev glavnega repozitorija
```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,18 +37,18 @@ 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 # Zgradi za produkcijo npm run build # Gradnja za produkcijo
npm run lint # Zaženi ESLint npm run lint # Zaženi ESLint
``` ```
### API za bankovni projekt (Node.js + Express) ### Bank Project API (Node.js + Express)
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm install npm install
npm start # Zaženi API strežnik npm start # Zaženi API strežnik
npm run lint # Zaženi ESLint npm run lint # Zaženi ESLint
npm run format # Oblikuj s Prettier npm run format # Oblikuj s Prettierjem
``` ```
### Projekti za razširitve brskalnika ### Projekti za razširitve brskalnika
@ -56,10 +56,10 @@ npm run format # Oblikuj s Prettier
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
npm install npm install
# Sledite navodilom za nalaganje razširitev, značilnim za brskalnik # Sledite navodilom za nalaganje razširitev, specifičnih za brskalnik
``` ```
### Projekti vesoljske igre ### Projekti igre Space Game
```bash ```bash
cd 6-space-game/solution cd 6-space-game/solution
@ -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 klepetalnega pomočnika (Python Backend) ### Chat projekt (Python Backend)
```bash ```bash
cd 9-chat-project/solution/backend/python cd 9-chat-project/solution/backend/python
@ -78,31 +78,31 @@ python api.py
## Razvojni potek dela ## Razvojni potek dela
### Za prispevajoče vsebino ### Za prispevke vsebin
1. **Razvezi skladišče (fork)** na svoj GitHub račun 1. **Razveji repozitorij** na svoj GitHub račun
2. **Kloniraj svoj fork** lokalno 2. **Kloniraj svoj razvej** lokalno
3. **Ustvari novo vejo** za svoje spremembe 3. **Ustvari novo vejo** za svoje spremembe
4. Naredi spremembe v vsebini lekcij ali primerih kode 4. Naredi spremembe v vsebini lekcij ali primerih kode
5. Preizkusi spremembe kode v relevantnih projektnikih 5. Preizkusi spremembe kode v relevantnih projektnih imenikih
6. Pošlji pull requeste v skladu z navodili za prispevke 6. Pošlji pull requeste skladno z navodili za prispevke
### Za učence ### Za učence
1. Razvezi ali kloniraj skladišče 1. Razveji ali kloniraj repozitorij
2. Postopoma obišči mape lekcij 2. Po vrsti obišči imenike lekcij
3. Preberi README datoteke za vsako lekcijo 3. Preberi README datoteke za vsako lekcijo
4. Opravi pred-lekcijske kvize na https://ff-quizzes.netlify.app/web/ 4. Izpolni pred-lekcijske kvize na https://ff-quizzes.netlify.app/web/
5. Prehod skozi primere kode v mapah lekcij 5. Delaj skozi primere kode v mapah lekcij
6. Dokončaj naloge in izzive 6. Naredi naloge in izzive
7. Opravi po-lekcijske kvize 7. Reši post-lekcijske kvize
### Živi razvoj ### Razvoj v živo
- **Dokumentacija**: Zaženi `docsify serve` v korenski mapi (port 3000) - **Dokumentacija**: zaženi `docsify serve` v korenski mapi (port 3000)
- **Quiz App**: Zaženi `npm run dev` v mapi quiz-app - **Quiz App**: zaženi `npm run dev` v imeniku quiz-app
- **Projekti**: Uporabi VS Code Live Server razširitev za HTML projekte - **Projekti**: uporabi VS Code Live Server razširitev za HTML projekte
- **API projekti**: Zaženi `npm start` v ustreznih API mapah - **API projekti**: zaženi `npm start` v ustreznih API imenikih
## Navodila za testiranje ## Navodila za testiranje
@ -119,73 +119,73 @@ npm run build # Preverite, ali se gradnja uspešno zaključi
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm run lint # Preveri težave s slogom kode npm run lint # Preveri težave s slogom kode
node server.js # Preveri, da strežnik začne brez napak node server.js # Preveri, če strežnik zažene brez napak
``` ```
### Splošni pristop k testiranju ### Splošen pristop k testiranju
- To je učni repozitorij brez obsežnih avtomatskih testov - To je izobraževalni repozitorij brez celovitih avtomatiziranih testov
- Ročno testiranje se osredotoča na: - Ročno testiranje se osredotoča na:
- Primere kode, ki se izvajajo brez napak - Primeri kode se izvajajo brez napak
- Delovanje povezav v dokumentaciji - Povezave v dokumentaciji delujejo pravilno
- Uspešno gradnjo projektov - Projekti se uspešno zgradijo
- Primeri sledijo najboljšim praksam - Primeri sledijo najboljšim praksam
### Preverjanja pred oddajo ### Preverjanja pred oddajo
- Zaženi `npm run lint` v mapah z datoteko package.json - Zaženi `npm run lint` v imenikih, kjer je package.json
- Preveri, da so markdown povezave veljavne - Preveri, da so markdown povezave veljavne
- Testiraj primere kode v brskalniku ali Node.js - Testiraj primere kode v brskalniku ali Node.js
- Preveri, da prevodi ohranjajo pravilno strukturo - Preveri, da prevodi ohranjajo pravilno strukturo
## Smernice glede sloga kode ## Smernice za stil kode
### JavaScript ### JavaScript
- Uporabljaj sodoben ES6+ zapis - Uporabi sodobno sintakso ES6+
- Sledi standardnim ESLint konfiguracijam v projektih - Sledi standardnim ESLint konfiguracijam, predvidenim v projektih
- Uporabljaj pomenljive spremenljivke in imena funkcij za jasnost izobraževanja - Uporabi smiselna imena spremenljivk in funkcij za jasnost izobraževanja
- Dodaj komentarje za razlago konceptov učencem - Dodaj komentarje, ki pojasnjujejo koncepte za učence
- Formatiraj s Prettier, kjer je konfiguriran - Formatiraj z uporabo Prettier, kjer je konfigurirano
### HTML/CSS ### HTML/CSS
- Semantični HTML5 elementi - Semantični HTML5 elementi
- Principi odzivnega dizajna - Principi odzivnega oblikovanja
- Jasne konvencije poimenovanja razredov - Jasne konvencije poimenovanja razredov
- Komentarji, ki pojasnjujejo CSS tehnike za učence - Komentarji, ki pojasnjujejo CSS tehnike za učence
### Python ### Python
- Smernice sloga PEP 8 - Smernice za stil PEP 8
- Jasni, izobraževalni primeri kode - Jasni, izobraževalni primeri kode
- Tipizacije tam, kjer so uporabne za učenje - Tipizacije tam, kjer pomagajo pri učenju
### Markdown dokumentacija ### Markdown dokumentacija
- Jasna hierarhija naslovov - Jasna hierarhija naslovov
- Kode v blokih z določeno jezikovno označbo - Bloki kode z označevanjem jezika
- Povezave do dodatnih virov - Povezave do dodatnih virov
- Posnetki zaslona in slike v imeniku `images/` - Posnetki zaslona in slike v imenikih `images/`
- Alt besedilo za slike zaradi dostopnosti - Alt besedila za slike za dostopnost
### Organizacija datotek ### Organizacija datotek
- Lekcije oštevilčene zaporedno (1-getting-started-lessons, 2-js-basics, itd.) - Lekcije so zaporedno oštevilčene (1-getting-started-lessons, 2-js-basics itd.)
- Vsak projekt ima mape `solution/` in pogosto `start/` ali `your-work/` - Vsak projekt ima imenike `solution/` in pogosto `start/` ali `your-work/`
- Slike shranjene v mapah lekcije v `images/` - Slike so shranjene v lekcijsko specifičnih mapah `images/`
- Prevodi v strukturi `translations/{language-code}/` - Prevodi so v strukturi `translations/{language-code}/`
## Gradnja in nameščanje ## Gradnja in namestitev
### Namestitev Quiz App (Azure Static Web Apps) ### Namestitev Quiz App (Azure Static Web Apps)
Quiz-app je konfiguriran za nameščanje na Azure Static Web Apps: quiz-app je konfiguriran za namestitev 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 nameščanje prek GitHub Actions poteka dela ob potisku na main # Izvede nameščanje preko GitHub Actions toka dela ob potisku na main
``` ```
Konfiguracija Azure Static Web Apps: Konfiguracija Azure Static Web Apps:
@ -197,27 +197,27 @@ Konfiguracija Azure Static Web Apps:
```bash ```bash
npm install # Namestite docsify-to-pdf npm install # Namestite docsify-to-pdf
npm run convert # Ustvari PDF iz docs npm run convert # Ustvarite PDF iz docs
``` ```
### Dokumentacija Docsify ### Docsify dokumentacija
```bash ```bash
npm install -g docsify-cli # Namestite Docsify globalno npm install -g docsify-cli # Namestite Docsify globalno
docsify serve # Postrežite na localhost:3000 docsify serve # Strežite na localhost:3000
``` ```
### Gradnje specifične za projekte ### Gradnja specifičnih projektov
Vsak projekt lahko ima svoj postopek gradnje: Vsak projektni imenik lahko vsebuje svoj gradbeni postopek:
- Vue projekti: `npm run build` ustvari produkcijske pakete - Vue projekti: `npm run build` ustvari produkcijske pakete
- Statični projekti: brez koraka gradnje, streže datoteke neposredno - Statični projekti: brez gradbenega koraka, streže datoteke neposredno
## Smernice za pull requeste ## Navodila za pull requeste
### Oblika naslova ### Oblika naslova
Uporabi jasne, opisne naslove, ki kažejo področje spremembe: Uporabi jasne, opisne naslove, ki označujejo področje spremembe:
- `[Quiz-app] Dodaj nov kviz za lekcijo X` - `[Quiz-app] Dodaj nov kviz za lekcijo X`
- `[Lesson-3] Popravi tipkarsko napako v projektu terrarium` - `[Lesson-3] Popravi tipkarsko napako v projektu terrarium`
- `[Translation] Dodaj španski prevod za lekcijo 5` - `[Translation] Dodaj španski prevod za lekcijo 5`
@ -228,55 +228,55 @@ Uporabi jasne, opisne naslove, ki kažejo področje spremembe:
Pred oddajo PR: Pred oddajo PR:
1. **Kakovost kode**: 1. **Kakovost kode**:
- Zaženi `npm run lint` v prizadetih projektnih mapah - Zaženi `npm run lint` v prizadetih imenikih projektov
- Odpravi vse napake in opozorila linterja - Odpravi vse napake in opozorila linterja
2. **Preverjanje gradnje**: 2. **Preverjanje gradnje**:
- Zaženi `npm run build`, če je potrebno - Zaženi `npm run build`, če je primerno
- Prepričaj se, da ni napak pri gradnji - Zagotovi, da ni napak pri gradnji
3. **Preverjanje povezav**: 3. **Preverjanje povezav**:
- Preizkusi vse markdown povezave - Preizkusi vse markdown povezave
- Preveri, da so reference na slike delujoče - Preveri delovanje slikovnih referenc
4. **Pregled vsebine**: 4. **Pregled vsebine**:
- Preberi za pravopisne in slovnične napake - Preveri pravopis in slovnico
- Preveri pravilnost in izobraževalno vrednost primerov kode - Zagotovi, da so primeri kode pravilni in izobraževalni
- Preveri, da prevodi ohranjajo prvotni pomen - Preveri, da prevodi ohranjajo prvotni pomen
### Zahteve za prispevke ### Zahteve za prispevanje
- Sprejmi Microsoftovo CLA (avtomatski pregled ob prvem PR) - Strinjaj se z Microsoft CLA (avtomatska preverba ob prvem PR)
- Sledi [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) - Sledi [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Poglej [CONTRIBUTING.md](./CONTRIBUTING.md) za podrobna navodila - Preberi [CONTRIBUTING.md](./CONTRIBUTING.md) za podrobna navodila
- V primeru potrebuje povezave do številk issue v opisu PR - V opisu PR po potrebi navedi številke issue-jev
### Postopek pregleda ### Proces pregleda
- PR pregledujejo vzdrževalci in skupnost - PR-je pregledujejo vzdrževalci in skupnost
- Prednost ima jasnost izobraževalne vsebine - Prioriteta je izobraževalna jasnost
- Primeri kode naj sledijo trenutnim najboljšim praksam - Primeri kode naj sledijo trenutnim najboljšim praksam
- Prevodi se pregledajo za točnost in kulturno ustreznost - Prevodi se pregledajo za točnost in kulturno ustreznost
## Sistem prevajanja ## Sistem prevajanja
### Avtomatizirani prevodi ### Avtomatiziran prevod
- Uporablja GitHub Actions z co-op-translator workflow - Uporablja GitHub Actions z delovnim tokom co-op-translator
- Samodejno prevaja v več kot 50 jezikov - Samodejno prevaja v več kot 50 jezikov
- Izvorne datoteke v glavnih mapah - Izvorne datoteke v glavnih imenikih
- Prevedene datoteke v mapi `translations/{language-code}/` - Prevedene datoteke v `translations/{language-code}/` imenikih
### Dodajanje ročnih izboljšav prevodov ### Dodajanje ročnih izboljšav prevoda
1. Najdi datoteko v `translations/{language-code}/` 1. Najdi datoteko v `translations/{language-code}/`
2. Naredi izboljšave ob ohranjanju strukture 2. Izvedi izboljšave ob ohranjanju strukture
3. Poskrbi, da primeri kode ostanejo funkcionalni 3. Poskrbi, da primeri kode ostanejo funkcionalni
4. Preizkusi vse lokalizirane kviz vsebine 4. Preizkusi vse lokalizirane vsebine kviza
### Metapodatki za prevode ### Metapodatki prevoda
Prevedene datoteke vsebujejo metapodatkovni naslov: Prevedene datoteke vsebujejo glavo metapodatkov:
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -293,90 +293,90 @@ CO_OP_TRANSLATOR_METADATA:
### Pogoste težave ### Pogoste težave
**Quiz app se ne zažene**: **Quiz aplikacija se ne zažene**:
- Preveri različico Node.js (priporočen v14+) - Preveri različico Node.js (priporočeno v14+)
- Izbriši `node_modules` in `package-lock.json`, ponovno zaženi `npm install` - Izbriši `node_modules` in `package-lock.json`, znova zaženi `npm install`
- Preveri konflikte vrat (privzeto: Vite uporablja port 5173) - Preveri, ali je vrata v uporabi (privzeto Vite uporablja vrata 5173)
**Strežnik API se ne zažene**: **API strežnik se ne zažene**:
- Preveri minimalno različico Node.js (node >=10) - Preveri, da je različica Node.js ustrezna (node >=10)
- Preveri, če vrata že niso zasedena - Preveri, če vrata niso že zasedena
- Zagotovi, 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**:
- Preveri, ali je manifest.json pravilno oblikovan - Preveri pravilno oblikovan manifest.json
- Preveri napake v konzoli brskalnika - Preveri konzolo brskalnika za napake
- Sledi navodilom za namestitev razširitve za določen brskalnik - Sledi navodilom za namestitev razširitve specifične za brskalnik
**Težave s projektnim klepetom (Python)**: **Težave s Python chat projektom**:
- Poskrbi, da je nameščen paket OpenAI: `pip install openai` - Preveri, da je nameščen paket OpenAI: `pip install openai`
- Preveri, da je okoljska spremenljivka GITHUB_TOKEN nastavljena - Preveri, da je nastavljena okoljska spremenljivka GITHUB_TOKEN
- Preveri dostopne pravice GitHub Modelov - Preveri dovoljenja za dostop do GitHub Modelov
**Docsify ne streže dokumentacije**: **Docsify ne streže dokumentacije**:
- Namesti docsify-cli globalno: `npm install -g docsify-cli` - Namesti docsify-cli globalno: `npm install -g docsify-cli`
- Zaženi z korenske mape repozitorija - Zaženi iz korenske mape repozitorija
- Preveri, da datoteka `docs/_sidebar.md` obstaja - Preveri, da obstaja `docs/_sidebar.md`
### Nasveti za razvojno okolje ### Nasveti za razvojno okolje
- Uporabljaj VS Code z Live Server razširitvijo za HTML projekte - Uporabi VS Code z razširitvijo Live Server za HTML projekte
- Namesti ESLint in Prettier razširitve za konsistentno oblikovanje - Namesti razširitve ESLint in Prettier za dosledno formatiranje
- Uporabi DevTools v brskalniku za odpravljanje napak v JavaScriptu - Uporabi DevTools brskalnika za odpravljanje napak v JavaScriptu
- Za Vue projekte namesti Vue DevTools razširitev brskalnika - Za Vue projekte namesti Vue DevTools brskalniško razširitev
### Upoštevanje zmogljivosti ### Premisleki glede zmogljivosti
- Veliko število prevedenih datotek (50+ jezikov) pomeni velike klone - Veliko število prevedenih datotek (več kot 50 jezikov) pomeni, da so popolni kloni veliki
- Uporabi plitek klon, če delaš samo z vsebino: `git clone --depth 1` - Za delo le z vsebino uporabi plitev klon: `git clone --depth 1`
- Izključi prevode iz iskanja med delom z angleško vsebino - Prevode izključi iz iskanja pri delu z angleško vsebino
- Gradbeni procesi so lahko počasni pri prvem zagonu (npm install, Vite build) - Gradbeni procesi so lahko počasni ob prvi izvedbi (npm install, Vite build)
## Varnostni ukrepi ## Varnostni premisleki
### Okoljske spremenljivke ### Okoljske spremenljivke
- Ključi API naj nikoli niso vključeni v repozitorij - Ključi API naj nikoli ne bodo dodani v repozitorij
- Uporabljaj `.env` datoteke (že vključene v `.gitignore`) - Uporabljaj `.env` datoteke (že vključene v `.gitignore`)
- Zabeleži potrebne okoljske spremenljivke v README projektov - Dokumentiraj zahtevane okoljske spremenljivke v README projektov
### Python projekti ### Python projekti
- Uporabljaj virtualna okolja: `python -m venv venv` - Uporabi virtualna okolja: `python -m venv venv`
- Održi odvisnosti posodobljene - Redno posodabljaj odvisnosti
- GitHub tokeni naj imajo minimalne potrebne pravice - GitHub tokeni naj imajo minimalna potrebna dovoljenja
### Dostop do GitHub Modelov ### Dostop do GitHub Modelov
- Potrebni so osebni dostopni žetoni (PAT) - Potrebni so osebni dostopni tokeni (PAT) za GitHub Modelle
- Žetone je treba shranjevati kot okoljske spremenljivke - Tokene je treba hraniti kot okoljske spremenljivke
- Nikoli jih ne vključi v repozitorij ali delilne datoteke - Nikoli ne komitiraj tokenov ali gesel
## Dodatne opombe ## Dodatne opombe
### Ciljna publika ### Ciljna publika
- Popolni začetniki v razvoju spletnih strani - Popolni začetniki v spletnem razvoju
- Študenti in samostojni učenci - Študenti in samouki
- Učitelji, ki uporabljajo učni načrt v učilnicah - Učitelji, ki uporabljajo učni načrt v razredih
- Vsebina je namenjena dostopnosti in postopnemu razvijanju veščin - Vsebina je zasnovana za dostopnost in postopno pridobivanje veščin
### Izobraževalna filozofija ### Izobraževalna filozofija
- Pristop učenja na osnovi projektov - Projektno usmerjen način učenja
- Pogoste preizkuse znanja (kvizi) - Pogoste preveritve znanja (kvizi)
- Praktične vaje s kodo - Praktične vaje s kodiranjem
- Prikazi primerov iz resničnega sveta - Primeri za uporabo v resničnem svetu
- Poudarek na osnovah pred okviri - Osredotočenost na osnove pred okviri
### Vzdrževanje repozitorija ### Vzdrževanje repozitorija
- Aktivna skupnost učencev in prispevkov - Aktivna skupnost učencev in prispevnikov
- Redne posodobitve odvisnosti in vsebine - Redne posodobitve odvisnosti in vsebine
- Vzdrževalci spremljajo zadeve in razprave - Spremljanje težav in diskusij s strani vzdrževalcev
- Posodobitve prevodov avtomatizirane prek GitHub Actions - Posodobitve prevodov avtomatizirane preko GitHub Actions
### Sorodni viri ### Povezani viri
- [Microsoft Learn moduli](https://docs.microsoft.com/learn/) - [Microsoft Learn moduli](https://docs.microsoft.com/learn/)
- [Student Hub viri](https://docs.microsoft.com/learn/student-hub/) - [Student Hub viri](https://docs.microsoft.com/learn/student-hub/)
@ -385,24 +385,24 @@ CO_OP_TRANSLATOR_METADATA:
### Delo s specifičnimi projekti ### Delo s specifičnimi projekti
Za podrobna navodila o posameznih projektih glej README datoteke v: Za podrobna navodila za posamezne projekte glej README datoteke v:
- `quiz-app/README.md` - Vue 3 aplikacija za kvize - `quiz-app/README.md` - Vue 3 kviz aplikacija
- `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 Canvasu - `6-space-game/README.md` - Razvoj igre na platnu (Canvas)
- `9-chat-project/README.md` - AI klepetalni pomočnik - `9-chat-project/README.md` - Projekt AI klepetalnega asistenta
### Struktura monorepo ### Struktura monorepo
Čeprav ni tradicionalni monorep, to skladišče vsebuje več neodvisnih projektov: Čeprav to ni tradicionalni monorepo, ta repozitorij vsebuje več neodvisnih projektov:
- Vsaka lekcija je samostojna - Vsaka lekcija je samostojna
- Projekti ne delijo odvisnosti - Projekti si ne delijo odvisnosti
- Delo na posameznih projektih brez vpliva na druge - Delo na posameznih projektih brez vpliva na druge
- Kloniraj celotno skladišče za polno učni izkušnjo - Kloniraj celoten repozitorij za celotno izkušnjo učnega načrta
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Omejitev odgovornosti**: **Omejitev odgovornosti**:
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 natančnost, vas opozarjamo, da avtomatizirani prevodi lahko vsebujejo napake ali netočnosti. Izvirni dokument v njegovem izvirnem jeziku velja za avtoritativni vir. Za ključne informacije priporočamo strokovni prevod, ki ga opravi človek. Nismo odgovorni za morebitna nesporazumevanja ali napačne interpretacije, ki izhajajo iz uporabe tega prevoda. Ta dokument je bil preveden z uporabo storitve za avtomatski prevod [Co-op Translator](https://github.com/Azure/co-op-translator). Čeprav si prizadevamo za natančnost, vas opozarjamo, da avtomatizirani prevodi lahko vsebujejo napake ali netočnosti. Izvirni dokument v njegovem matičnem jeziku velja za avtoritativni vir. Za pomembne informacije priporočamo strokovni človeški prevod. Za kakršna koli nesporazume ali napačne interpretacije, ki izhajajo iz uporabe tega prevoda, ne odgovarjamo.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->

6
translations/sr/.co-op-translator.json
Unescape View File

@ -1,7 +1,7 @@
{ {
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": { "1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8", "original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-06T15:00:07+00:00", "translation_date": "2026-03-27T23:29:14+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md", "source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "sr" "language_code": "sr"
}, },
@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T15:13:43+00:00", "translation_date": "2026-03-27T23:37:15+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "sr" "language_code": "sr"
}, },

716
translations/sr/1-getting-started-lessons/1-intro-to-programming-languages/README.md
View File

File diff suppressed because it is too large Load Diff

336
translations/sr/AGENTS.md
Unescape View File

@ -2,29 +2,29 @@
## Преглед пројекта ## Преглед пројекта
Ово је репозиторијум образовног курикулума за подучавање основа веб развоја почетницима. Курикулум је свеобухватни курс од 12 недеља развијен од стране Microsoft Cloud Advocates-а, који садржи 24 практичне лекције које обухватају JavaScript, CSS и HTML. Ово је репозиторијум едукативног наставног плана за подучавање основа веб развоја почетницима. Наставни план је свеобухватан курс од 12 недеља, који су развили Microsoft Cloud Advocates, и садржи 24 практичне лекције које обухватају JavaScript, CSS и HTML.
### Кључне компоненте ### Кључне компоненте
- **Образовни садржај**: 24 структуриране лекције организоване у модуле базиране на пројектима - **Едукативни садржај**: 24 структуриране лекције организоване у модуле засноване на пројектима
- **Практични пројекти**: Терраријум, Игра куцања, Проширење прегледача, Свемирска игра, Банкарска апликација, Уредник кода и AI помоћник за чет - **Практични пројекти**: Тераријум, Игра куцања, Прегледачки екстензија, Свемирска игра, Банкарска апликација, Уредник кода и AI асистент за чет
- **Интерактивни квизови**: 48 квизова са по 3 питања сваки (пре/после-лекцијске процене) - **Интерактивни квизови**: 48 квизова са по 3 питања (процене пре/после лекције)
- **Подршка за више језика**: Аутоматски преводи на 50+ језика преко GitHub Actions - **Подршка за више језика**: Аутоматизовани преводи за 50+ језика путем GitHub Actions
- **Технологије**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (за AI пројекте) - **Технологије**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (за AI пројекте)
### Архитектура ### Архитектура
- Образовни репозиторијум са структуром заснованом на лекцијама - Едукативни репозиторијум са структуом по лекцијама
- Свакa фасцикла лекције садржи README, примере кода и решења - Свака фасцикла лекције садржи README, примере кода и решења
- Самостални пројекти у засебним директоријумима (quiz-app, различити пројекти лекција) - Самостални пројекти у посебним директоријумима (quiz-app, различити пројекти лекција)
- Систем превођења користећи GitHub Actions (co-op-translator) - Систем превођења користећи GitHub Actions (co-op-translator)
- Документација послужена преко Docsify-а и доступна као PDF - Документација доступна преко Docsify и у PDF формату
## Команде за подешавање ## Команде за подешавање
Овај репозиторијум је углавном за конзумирање образовног садржаја. За рад са специфичним пројектима: Овај репозиторијум је првенствено намењен за конзумирање едукативног садржаја. За рад са специфичним пројектима:
### Основно подешавање репозиторијума ### Главно подешавање репозиторијума
```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,29 +37,29 @@ cd Web-Dev-For-Beginners
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
``` ```
### Bank Project API (Node.js + Express) ### API банкарског пројекта (Node.js + Express)
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm install npm install
npm start # Покрени API сервер npm start # Покрени API сервер
npm run lint # Покрени ESLint npm run lint # Покрени ESLint
npm run format # Форматирај са Prettier npm run format # Форматирај помоћу Prettier
``` ```
### Пројекти проширења прегледача ### Пројекти прегледачких екстензија
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
npm install npm install
# Пратите упутства за учитавање проширења специфична за прегледач # Пратите упутства за учитавање екстензија специфична за прегледач
``` ```
### Пројекти Свемирске игре ### Пројекти свемирске игре
```bash ```bash
cd 6-space-game/solution cd 6-space-game/solution
@ -67,86 +67,86 @@ npm install
# Отворите index.html у прегледачу или користите Live Server # Отворите index.html у прегледачу или користите Live Server
``` ```
### Chat Пројекат (Python Backend) ### Пројекат чет (Python backend)
```bash ```bash
cd 9-chat-project/solution/backend/python cd 9-chat-project/solution/backend/python
pip install openai pip install openai
# Подеси GITHUB_TOKEN променљиву окружења # Поставите променљиву окружења GITHUB_TOKEN
python api.py python api.py
``` ```
## Работни ток развоја ## Радар развоја
### За сараднике на садржају ### За сараднике на садржају
1. **Направите fork** репозиторијума на свој GitHub налог 1. **Форкнути репозиторијум** на свој GitHub налог
2. **Клонирајте свој fork** локално 2. **Клонирати форк** локално
3. **Направите нову грану** за ваше измене 3. **Направити нову грану** за измене
4. Правите измене у садржају лекција или примерима кода 4. Извршити измене у наставном садржају или примерима кода
5. Тестирајте измене кода у релевантним директоријумима пројеката 5. Тестирати промене кода у релевантним директоријумима пројеката
6. Пошаљите pull requests пратећи смернице за допринос 6. Послати pull request према правилима доприноса
### За ученике ### За ученике
1. Направите fork или клонирајте репозиторијум 1. Форкнути или клонирати репозиторијум
2. Користите се директоријумима лекција по редоследу 2. Ићи кроз фасцикле лекција по реду
3. Прочитајте README фајлове за сваку лекцију 3. Читати README датотеке за сваку лекцију
4. Решевајте пред-лекцијске квизове на https://ff-quizzes.netlify.app/web/ 4. Решавати предлессон квизове на https://ff-quizzes.netlify.app/web/
5. Радите кроз примере кода у фасциклама лекција 5. Радити на примерима кода у фасциклама лекција
6. Завршите задатке и изазове 6. Завршавати задатке и изазове
7. Решите пост-лекцијске квизове 7. Решавати после-лекционе квизове
### Ливе развој ### Ливе развој
- **Документација**: Покрените `docsify serve` из корена (порта 3000) - **Документација**: Покренути `docsify serve` у корену (порт 3000)
- **Quiz App**: Покрените `npm run dev` у директоријуму quiz-app - **Quiz App**: Покренути `npm run dev` у директоријуму quiz-app
- **Пројекти**: Користите VS Code Live Server проширење за HTML пројекте - **Пројекти**: Користити VS Code Live Server екстензију за HTML пројекте
- **API Пројекти**: Покрените `npm start` у одговарајућим API директоријумима - **API пројекти**: Покренути `npm start` у одговарајућим API директоријумима
## Упутства за тестирање ## Упутства за тестирање
### Тестирање Quiz App-а ### Тестирање Quiz App
```bash ```bash
cd quiz-app cd quiz-app
npm run lint # Проверите проблеме са стилом кода npm run lint # Проверите проблеме стила кода
npm run build # Потврдите да је изградња успела npm run build # Проверите да ли градња успева
``` ```
### Тестирање Bank API-ја ### Тестирање 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 # Проверити да ли сервер почиње без грешака
``` ```
### Општи приступ тестирању ### Општи приступ тестирању
- Ово је образовни репозиторијум без свеобухватних аутоматизованих тестова - Ово је едукативни репозиторијум без свеобухватних аутоматизованих тестова
- Ручно тестирање фокусира се на: - Ручно тестирање се фокусира на:
- Примери кода се извршавају без грешака - Примере кода који се извршавају без грешака
- Линкови у документацији исправно раде - Проверу да линкови у документацији исправно раде
- Пројекти се успешно граде - Успешно компилацију пројеката
- Примери следе добре праксе - Примере који прате најбоље праксе
### Провере пре слања ### Провере пре слања
- Покрените `npm run lint` у директоријумима са package.json фајлом - Покренути `npm run lint` у директоријумима који садрже package.json
- Верификујте да су markdown линкови валидни - Верификовати да су markdown линкови исправни
- Тестирајте примере кода у прегледачу или Node.js-у - Тестирати примере кода у прегледачу или Node.js
- Проверите да преводи очувају исправну структуру - Проверити да преводи одржавају исправну структуру
## Упутства за стил кода ## Упутства за стил кода
### JavaScript ### JavaScript
- Користите модерну ES6+ синтаксу - Користити савремен ES6+ синтакс
- Пратите стандардне ESLint конфигурације у пројектима - Пратити стандардне ESLint конфигурације из пројеката
- Користите значења у именима променљивих и функција ради образовне јасноће - Користити смислене називе променљивих и функција ради едукативне јасноће
- Додајте коментаре који објашњавају концепте за ученике - Додавати коментаре који објашњавају појмове за ученике
- Форматирајте користећи Prettier где је конфигурисан - Форматирати код користећи Prettier тамо где је конфигурисан
### HTML/CSS ### HTML/CSS
@ -157,126 +157,126 @@ node server.js # Потврди да се сервер покреће без
### Python ### Python
- Поштујте PEP 8 стилске смернице - Пратите PEP 8 стилске смернице
- Јасни, образовни примери кода - Јасни, едукативни примери кода
- Типске наговештаје где су корисни за учење - Типска анализа где помаже за учење
### Markdown документација ### Markdown документација
- Јасна хијерархија наслова - Јасна хијерархија наслова
- Блокови кода са одређеним језиком - Блокови кода са спецификацијом језика
- Линкови ка додатним ресурсима - Линкови ка додатним ресурсима
- Скриншотови и слике у `images/` директоријумима - Снимци екрана и слике у `images/` фасциклама
- Alt текст за слике ради приступачности - Alt текст за слике ради приступачности
### Организација фајлова ### Организација фајлова
- Лекције нумерисане по редоследу (1-getting-started-lessons, 2-js-basics, итд.) - Лекције нумерисане узастопно (1-getting-started-lessons, 2-js-basics итд.)
- Сваки пројекат има `solution/` и често `start/` или `your-work/` директоријуме - Сваки пројекат има директоријуме `solution/` и често `start/` или `your-work/`
- Слике смештене у лекцијски специфичне `images/` фасцикле - Слике се чувају у лекцијским `images/` фасциклама
- Преводи у структури `translations/{language-code}/` - Преводи у структури `translations/{language-code}/`
## Изградња и деплој ## Изградња и распоређивање
### Деплој Quiz App-а (Azure Static Web Apps) ### Распоређивање Quiz App (Azure Static Web Apps)
quiz-app је конфигурисан за деплој на 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 радног тока при слању на main
``` ```
Конфигурација Azure Static Web Apps: Конфигурација Azure Static Web Apps:
- **Локација апликације**: `/quiz-app` - **Локација апликације**: `/quiz-app`
- **Локација излазног фајла**: `dist` - **Излазна локација**: `dist`
- **Радни ток**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Генерација PDF документације ### Генерисање PDF документације
```bash ```bash
npm install # Инсталирај docsify-to-pdf npm install # Инсталирај docsify-to-pdf
npm run convert # Креирај PDF из докс npm run convert # Генериши PDF из докса
``` ```
### Docsify документација ### Docsify документација
```bash ```bash
npm install -g docsify-cli # Инсталирајте Docsify глобално npm install -g docsify-cli # Инсталирајте Docsify глобално
docsify serve # Покрените на localhost:3000 docsify serve # Сервирајте на localhost:3000
``` ```
### Изградња специфична по пројекту ### Изградња специфична за пројекте
Свако директоријум пројекта може имати свој процес изградње: Сваки пројекат може имати свој процес изградње:
- Vue пројекти: `npm run build` ствара продукционе пакете - Vue пројекти: `npm run build` креира продукционе пакете
- Статички пројекти: Нема корака изградње, фајлови се директно служе - Статички пројекти: Нема корака изградње, сервер директно служи фајлове
## Смернице за Pull Request-ове ## Упутства за Pull Request
### Формат наслова ### Формат наслова
Користите јасне, описне наслове који указују на подручје измене: Користити јасне, описне наслове који указују на област промене:
- `[Quiz-app] Додај нови квиз за лекцију X` - `[Quiz-app] Додај нови квиз за лекцију X`
- `[Lesson-3] Исправка грешке у терраријум пројекту` - `[Lesson-3] Исправи типографску грешку у пројекту тераријум`
- `[Translation] Додај шпански превод за лекцију 5` - `[Translation] Додај шпански превод за лекцију 5`
- `[Docs] Ажурирај упутства за подешавање` - `[Docs] Ажурирај упутства за подешавање`
### Обавезне провере ### Обавезне проверe
Пре слања PR-а: Пре слања PR:
1. **Квалитет кода**: 1. **Квалитет кода**:
- Покрените `npm run lint` у погођеним директоријумима - Покренути `npm run lint` у директиоријумима погођеним променама
- Исправите све грешке и упозорења - Поправити све lint грешке и упозорења
2. **Верификација изградње**: 2. **Провера изградње**:
- Покрените `npm run build` ако је применљиво - Покренути `npm run build` ако је применљиво
- Уверите се да нема грешака приликом изградње - Осигурати да нема грешака при изградњи
3. **Валидација линкова**: 3. **Валидација линкова**:
- Тестирајте све markdown линкове - Тестирати све markdown линкове
- Проверите да референце слика раде - Проверити референце слика
4. **Преглед садржаја**: 4. **Преглед садржаја**:
- Прочитајте и проверите правопис и граматику - Проверити правопис и граматику
- Уверите се да су примери кода тачни и образовни - Осигурати да су примери кода исправни и образовни
- Проверите да преводи очувају оригинално значење - Верификовати да преводи задржавају оригинално значење
### Захтеви за допринос ### Захтеви за допринос
- Прихватите Microsoft CLA (аутоматска провера при првом PR-у) - Прихватити Microsoft CLA (аутоматска провера при првом PR)
- Пратите [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) - Пратити [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Погледајте [CONTRIBUTING.md](./CONTRIBUTING.md) за детаљна упутства - Погледати [CONTRIBUTING.md](./CONTRIBUTING.md) за детаљне смернице
- Унесите бројеве issue-ја у опис PR-а ако је применљиво - Навести бројеве issue-ова у опису PR-а ако је применљиво
### Процес ревизије ### Процес прегледа
- PR-ове прегледају одржаваоци и заједница - PR прегледају одржаваоци и заједница
- Приоритет је образовна јасноћа - Јасноћа образовања је приоритет
- Примери кода требају пратити најбоље праксе - Примери кода треба да прате најновије добре праксе
- Преводи се прегледају ради тачности и културне прикладности - Преводи се прегледају ради тачности и културне прикладности
## Систем превођења ## Систем превођења
### Аутоматски превод ### Аутоматизовани превод
- Користи GitHub Actions са co-op-translator радним током - Користи GitHub Actions са co-op-translator workflow-ом
- Аутоматски преводи на преко 50 језика - Преводи на 50+ језика аутоматски
- Иза изворних фајлова у главним директоријумима - Изворне датотеке у главним директоријумима
- Преведени фајлови у `translations/{language-code}/` директоријумима - Преведене датотеке у структури `translations/{language-code}/`
### Додавање ручних побољшања превода ### Додавање ручних побољшања превода
1. Пронађите фајл у `translations/{language-code}/` 1. Пронађите фајл у `translations/{language-code}/`
2. Направите побољшања уз очување структуре 2. Направите побољшања уз очување структуре
3. Уверите се да примери кода остају функционални 3. Осигурајте да примери кода остају функционални
4. Тестирајте локализовани квиз садржај 4. Тестирајте било који локализовани квиз садржај
### Мета подаци превода ### Мета подаци о преводима
Преведени фајлови укључују заглавље са мета подацима: Преведене датотеке укључују заглавље мета података:
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
--> -->
``` ```
## Отстрањивање грешака и решавање проблема ## Решавање проблема и дијагностика
### Уобичајени проблеми ### Уобичајени проблеми
**Quiz app не може да се покрене**: **Quiz app не почиње**:
- Проверите верзију Node.js (препоручује се v14+) - Проверите верзију Node.js (препоручено v14+)
- Обришите `node_modules` и `package-lock.json`, покрените поново `npm install` - Обришите `node_modules` и `package-lock.json`, па поново покрените `npm install`
- Проверите конфликте портова (подразумевано: Vite користи порт 5173) - Проверите да ли је порт слободан (подразумевано: Vite користи порт 5173)
**API сервер се не покреће**: **API сервер не почиње**:
- Потврдите да је Node.js верзија најмање 10 - Проверите да Node.js верзија испуњава минимум (node >=10)
- Проверите да ли је порт у употреби - Проверите да ли је порт већ у употреби
- Уверите се да су све зависности инсталиране са `npm install` - Осигурајте да су све зависности инсталиране преко `npm install`
**Проширење прегледача се не учитава**: **Прегледачки екстензијa не учитава**:
- Проверите да је manifest.json правилно форматиран - Проверите да je manifest.json исправно форматиран
- Прегледајте конзолу прегледача за грешке - Проверите конзолу прегледача за грешке
- Пратите упутства специфична за инсталацију проширења прегледача - Пратите упутства за инсталацију прегледачких екстензија
**Проблеми са Python chat пројектом**: **Проблеми са Python чет пројектом**:
- Уверите се да је OpenAI пакет инсталиран: `pip install openai` - Проверите да је пакет OpenAI инсталиран: `pip install openai`
- Проверите да је окружење променљива GITHUB_TOKEN подешена - Проверите да је постављена GITHUB_TOKEN променљива окружења
- Проверите дозволе за приступ GitHub Models - Проверите дозволе за приступ GitHub моделима
**Docsify не служи документацију**: **Docsify не служи документацију**:
- Глобално инсталирајте docsify-cli: `npm install -g docsify-cli` - Инсталирајте docsify-cli глобално: `npm install -g docsify-cli`
- Покрените из корена репозиторијума - Покрените из корена репозиторијума
- Проверите да `docs/_sidebar.md` постоји - Проверите да ли `docs/_sidebar.md` постоји
### Савети за развојно окружење ### Савети за развојно окружење
- Користите VS Code са Live Server проширењем за HTML пројекте - Користите VS Code са Live Server екстензијом за HTML пројекте
- Инсталирајте ESLint и Prettier проширења за доследно форматирање - Инсталирајте ESLint и Prettier екстензије за доследно форматирање
- Користите DevTools прегледача за дебаговање JavaScript-а - Користите алате прегледача за дебаговање JavaScript-а
- За Vue пројекте, инсталирајте Vue DevTools проширење за прегледач - За Vue пројекте инсталирајте Vue DevTools екстензију за прегледач
### Примедбе у вези перформанси ### Примедбе о перформансама
- Велики број преведених фајлова (50+ језика) резултира великим клоновима - Већи број преведених фајлова (50+ језика) чини пун клон великим
- Користите shallow clone ако радите само на садржају: `git clone --depth 1` - Користите shallow clone ако радите само на садржају: `git clone --depth 1`
- Искључите преводе из претрага када радите на енглеском садржају - Изузмите преводе из претрага при раду само на енглеском садржају
- Процеси изградње могу бити спори при првом покретању (npm install, Vite build) - Процеси изградње могу бити спори при првом покретању (npm install, Vite build)
## Безбедносне примедбе ## Безбедносне препоруке
### Окружне променљиве ### Променљиве окружења
- API кључеви никада не смеју бити комитовани у репозиторијум - API кључеви никад не смеју бити снимљени у репозиторијум
- Користите `.env` фајлове (већ у `.gitignore`) - Користите `.env` фајлове (већ у `.gitignore`)
- Документујте потребне окружне променљиве у README фајловима пројеката - Документирајте потребне променљиве окружења у README-јима пројеката
### Python пројекти ### Python пројекти
- Користите виртуелна окружења: `python -m venv venv` - Користите виртуелне енвиронменте: `python -m venv venv`
- Одржавајте зависности ажурним - Одржавајте зависности ажурним
- GitHub токени требају имати минималне потребне дозволе - GitHub токени треба да имају минималне потребне дозволе
### Приступ GitHub Models ### Приступ GitHub моделима
- Лични приступни токени (PAT) су неопходни за GitHub Models - Потребни Personal Access Tokens (PAT) за GitHub Моделе
- Токени треба да се чувају као окружне променљиве - Токени требa да се чувају као променљиве окружења
- Никад не комитујте токене или креденцијале - Никада не комитујте токене или акредитиве
## Додатне напомене ## Додатне напомене
### Циљна публика ### Циљна публика
- Потпуни почетници у веб развоју - Потпуни почетници у веб развоју
- Студенти и самоученици - Студенти и самоуки учесници
- Наставници који користе курикулум у учионицама - Наставници који користе наставни план у учионици
- Садржај је дизајниран за приступачност и постепено стицање вештина - Садржај је дизајниран за приступачност и постепено стицање вештина
### Образовна филозофија ### Едукативна филозофија
- Приступ учењу заснован на пројектима - Приступ учењу заснован на пројектима
- Чести провери знања (квизови) - Чести проверавања знања (квизови)
- Практичне вежбе кода - Практичне вежбе кодирања
- Примери примене у реалном свету - Примери из стварног света
- Фокус на основе пре рада са фрејмворковима - Фокус на основе пре фронт-енд оквира
### Одржавање репозиторијума ### Одржавање репозиторијума
- Активна заједница учесника и сарадника - Активна заједница ученика и сарадника
- Редовна ажурирања зависности и садржаја - Редовна ажурирања зависности и садржаја
- Праћење проблема и дискусија од стране одржаваоца - Пратња issue-ова и дискусија од стране одржалаца
- Аутоматско ажурирање превода преко GitHub Actions - Аутоматизовани преводи путем GitHub Actions
### Повезани ресурси ### Повезани ресурси
- [Microsoft Learn модули](https://docs.microsoft.com/learn/) - [Microsoft Learn модули](https://docs.microsoft.com/learn/)
- [Student Hub ресурси](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) препоручен за ученике - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) препоручује се за ученике
- Додатни курсеви: Generative AI, Data Science, ML, IoT курикулуми доступни - Додатни курсеви: Generative AI, Data Science, ML, IoT наставни планови доступни
### Рад са специфичним пројектима ### Рад са специфичним пројектима
За детаљна упутства о појединачним пројектима, погледајте README фајлове у: За детаљна упутства о појединачним пројектима, погледајте README фајлове у:
- `quiz-app/README.md` - Vue 3 квиз апликација - `quiz-app/README.md` - Vue 3 квиз апликација
- `7-bank-project/README.md` - Банкарска апликација са аутентификацијом - `7-bank-project/README.md` - Банкарска апликација са аутентификацијом
- `5-browser-extension/README.md` - Развој проширења прегледача - `5-browser-extension/README.md` - Развој прегледачких екстензија
- `6-space-game/README.md` - Развој Canvas основе за игру - `6-space-game/README.md` - Развој Canvas игре
- `9-chat-project/README.md` - AI асистент за чет пројекат - `9-chat-project/README.md` - Пројекат AI асистента за чет
### Монорепо структура ### Монорепо структура
Иако није традиционално монорепо, овај репозиторијум садржи више независних пројеката: Иако није класично монорепо, овај репозиторијум садржи више независних пројеката:
- Свaka лекција је самостална - Свака лекција је самостална
- Пројекти не деле зависности - Пројекти не деле зависности
- Радите на појединачним пројектима без утицаја на друге - Радите на појединачним пројектима без утицаја на друге
- Клонирајте цео репозиторијум ради пуног искуства курикулума - Клонирајте цео репозиторијум за потпуно искуство наставног плана
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Ограничење одговорности**: **Искључење одговорности**:
Овај документ је преведен помоћу AI преводилачке услуге [Co-op Translator](https://github.com/Azure/co-op-translator). Иако тежимо тачности, молимо имајте у виду да аутоматизовани преводи могу садржати грешке или нетачности. Изворни документ на његовом оригиналном језику треба сматрати ауторитетним извором. За критичне информације препоручује се професионални људски превод. Нисмо одговорни за било каква непоразумевања или погрешне тумачења која произилазе из коришћења овог превода. Овај документ је преведен помоћу AI сервиса за превод [Co-op Translator](https://github.com/Azure/co-op-translator). Иако тежимо тачности, молимо имајте у виду да аутоматски преводи могу садржати грешке или нетачности. Оригинални документ на његовом изворном језику треба сматрати ауторитетним извором. За критичне информације препоручује се професионални људски превод. Нисмо одговорни за било каква неспоразумевања или погрешне интерпретације које произлазе из коришћења овог превода.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->
Write Preview
Loading…
Cancel
Save