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, 6 changes)

Browse Source
pull/1690/head
localizeflow[bot] 3 weeks ago
parent ee58750ae9
commit 75e8cf5f1e
6 changed files with 580 additions and 582 deletions
Show Stats Download Patch File Download Diff File

2
translations/cs/.co-op-translator.json
Unescape View File

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T11:52:46+00:00",
"translation_date": "2026-02-06T13:19:19+00:00",
"source_file": "AGENTS.md",
"language_code": "cs"
},

394
translations/cs/AGENTS.md
Unescape View File

@ -2,27 +2,27 @@
## Přehled projektu
Toto je vzdělávací repozitář kurikula pro výuku základů webového vývoje pro začátečníky. Kurikulum je komplexní 12týdenní kurz vyvinutý Microsoft Cloud Advocates, obsahující 24 praktických lekcí pokrývajících JavaScript, CSS a HTML.
Toto je vzdělávací repozitář kurikula pro výuku základů webového vývoje pro začátečníky. Kurikulum je komplexní 12-týdenní kurz vyvinutý týmem Microsoft Cloud Advocates, obsahující 24 praktických lekcí pokrývajících JavaScript, CSS a HTML.
### Klíčové součásti
- **Vzdělávací obsah**: 24 strukturovaných lekcí uspořádaných do modulů založených na projektech
- **Praktické projekty**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor a AI Chat Assistant
- **Interaktivní kvízy**: 48 kvízů po 3 otázkách (před a po lekci)
- **Vícejazyčná podpora**: Automatické překlady do více než 50 jazyků pomocí GitHub Actions
- **Technologie**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (pro AI projekty)
- **Vzdělávací obsah**: 24 strukturovaných lekcí uspořádaných do modulů založených na projektech
- **Praktické projekty**: Terrárium, Hra psaní, Rozšíření prohlížeče, Hra ve vesmíru, Bankovní aplikace, Kódový editor a AI chatovací asistent
- **Interaktivní kvízy**: 48 kvízů s 3 otázkami každý (před/po lekci)
- **Vícejazyčná podpora**: Automatizované překlady do více než 50 jazyků pomocí GitHub Actions
- **Technologie**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (pro AI projekty)
### Architektura
- Edukační repozitář se strukturou založenou na lekcích
- Každá složka lekce obsahuje README, ukázky kódu a řešení
- Samostatné projekty v oddělených adresářích (quiz-app, různé projektové lekce)
- Překladový systém používající GitHub Actions (co-op-translator)
- Dokumentace servírovaná pomocí Docsify a dostupná také jako PDF
- Vzdělávací repozitář se strukturou založenou na lekcích
- Každá složka lekce obsahuje README, příklady kódu a řešení
- Samostatné projekty ve zvláštních adresářích (quiz-app, různé projekty lekcí)
- Překladový systém využívající GitHub Actions (co-op-translator)
- Dokumentace servírovaná přes Docsify a dostupná jako PDF
## Příkazy pro nastavení
Tento repozitář je primárně určen ke konzumaci vzdělávacího obsahu. Pro práci se specifickými projekty:
Tento repozitář je primárně určen pro konzumaci vzdělávacího obsahu. Pro práci s konkrétními projekty:
### Nastavení hlavního repozitáře
@ -36,8 +36,8 @@ cd Web-Dev-For-Beginners
```bash
cd quiz-app
npm install
npm run dev # Spustit vývojový server
npm run build # Sestavit pro produkci
npm run dev # Spusťte vývojový server
npm run build # Vytvořit produkční verzi
npm run lint # Spustit ESLint
```
@ -46,9 +46,9 @@ npm run lint # Spustit ESLint
```bash
cd 7-bank-project/api
npm install
npm start # Spustit API server
npm run lint # Spustit ESLint
npm run format # Formátovat pomocí Prettier
npm start # Spusťte API server
npm run lint # Spusťte ESLint
npm run format # Formátujte pomocí Prettier
```
### Projekty rozšíření prohlížeče
@ -59,7 +59,7 @@ npm install
# Postupujte podle pokynů pro načítání rozšíření specifických pro prohlížeč
```
### Projekty Space Game
### Projekty hry ve vesmíru
```bash
cd 6-space-game/solution
@ -67,7 +67,7 @@ npm install
# Otevřete index.html v prohlížeči nebo použijte Live Server
```
### Chat projekt (Python Backend)
### Chat projekt (Python backend)
```bash
cd 9-chat-project/solution/backend/python
@ -76,42 +76,42 @@ pip install openai
python api.py
```
## Vývojový workflow
## Vývojový proces
### Pro přispěvatele obsahu
1. **Forkujte repozitář** do svého GitHub účtu
2. **Naklonujte svůj fork** lokálně
3. **Vytvořte novou větev** pro své změny
4. Proveďte změny ve výukovém obsahu nebo ukázkách kódu
5. Otestujte jakékoliv změny kódu v relevantních projektových složkách
6. Podávejte pull requesty podle pokynů k přispívání
1. **Forkněte repozitář** na svůj GitHub účet
2. **Naklonujte svůj fork** lokálně
3. **Vytvořte novou větev** pro změny
4. Proveďte změny v obsahu lekcí nebo příkladech kódu
5. Testujte jakékoliv změny kódu v příslušných adresářích projektů
6. Odesílejte pull requesty v souladu s pokyny na přispívání
### Pro studenty
1. Forkujte nebo naklonujte repozitář
2. Procházejte složky lekcí postupně
3. Čtěte README soubory každé lekce
4. Dokončete před-učební kvízy na https://ff-quizzes.netlify.app/web/
5. Procházejte ukázky kódu v lekčních složkách
6. Splňte úkoly a výzvy
7. Odevzdejte post-učební kvízy
1. Forkněte nebo klonujte repozitář
2. Procházejte adresáře lekcí postupně
3. Čtěte README soubory u každé lekce
4. Dokončete před-lekční kvízy na https://ff-quizzes.netlify.app/web/
5. Projděte příklady kódu v adresářích lekcí
6. Dokončete úkoly a výzvy
7. Absolvujte kvízy po lekci
### Živý vývoj
### Live vývoj
- **Dokumentace**: Spusťte `docsify serve` v kořenovém adresáři (port 3000)
- **Quiz App**: Spusťte `npm run dev` ve složce quiz-app
- **Projekty**: Používejte VS Code rozšíření Live Server pro HTML projekty
- **API Projekty**: Spouštějte `npm start` v příslušných API adresářích
- **Dokumentace**: Spusťte `docsify serve` v kořenovém adresáři (port 3000)
- **Quiz App**: Spusťte `npm run dev` v adresáři quiz-app
- **Projekty**: Použijte VS Code Live Server rozšíření pro HTML projekty
- **API projekty**: Spusťte `npm start` v příslušných API adresářích
## Testovací instrukce
## Instrukce pro testování
### Testování Quiz App
```bash
cd quiz-app
npm run lint # Zkontrolujte problémy se stylem kódu
npm run build # Ověřte, že sestavení proběhlo úspěšně
npm run build # Ověřte, že sestavení je úspěšné
```
### Testování Bank API
@ -124,59 +124,59 @@ node server.js # Ověřte, že server startuje bez chyb
### Obecný přístup k testování
- Jedná se o edukativní repozitář bez komplexních automatizovaných testů
- Manuální testování se zaměřuje na:
- Spouštění ukázek kódu bez chyb
- Fungování odkazů v dokumentaci
- Úspěšné dokončení buildů projektů
- Dodržování osvědčených postupů v příkladech
- Tento repozitář je vzdělávací a neobsahuje rozsáhlé automatizované testy
- Ruční testování se zaměřuje na:
- Příklady kódu bez chyb při spuštění
- Funkčnost odkazů v dokumentaci
- Úspěšné sestavení projektů
- Dodržování nejlepších praktik v příkladech
### Kontroly před odesláním
- Spusťte `npm run lint` v adresářích s package.json
- Ověřte správnost markdown odkazů
- Testujte ukázky kódu v prohlížeči nebo Node.js
- Zkontrolujte, že překlady zachovávají správnou strukturu
- Spusťte `npm run lint` v adresářích s package.json
- Ověřte validitu markdown odkazů
- Otestujte příklady kódu v prohlížeči nebo Node.js
- Zkontrolujte, že překlady zachovávají správnou strukturu
## Pravidla pro styl kódu
## Pravidla stylu kódu
### JavaScript
- Používat moderní ES6+ syntaxi
- Dodržovat standardní ESLint konfigurace v projektech
- Používat smysluplné názvy proměnných a funkcí pro přehlednost
- Přidávat komentáře vysvětlující koncepty pro studenty
- Formátovat pomocí Prettier tam, kde je nastavena konfigurace
- Používejte moderní syntax ES6+
- Dodržujte standardní konfigurace ESLint v projektech
- Používejte smysluplná jména proměnných a funkcí pro lepší vzdělávací přehlednost
- Přidávejte komentáře vysvětlující koncepty pro studenty
- Formátujte pomocí Prettier tam, kde je nakonfigurován
### HTML/CSS
- Používat sémantické HTML5 prvky
- Dodržovat principy responzivního designu
- Jasná konvence pojmenování tříd
- Komentáře vysvětlující CSS techniky pro studenty
- Používejte sémantické elementy HTML5
- Principy responsivního designu
- Jasné pojmenování tříd
- Komentáře vysvětlující CSS techniky pro studenty
### Python
- Dodržovat PEP 8 stylové směrnice
- Jasné, výukové příklady kódu
- Typové anotace tam, kde jsou užitečné pro učení
- Dodržujte stylové směrnice PEP 8
- Jasné a vzdělávací příklady kódu
- Typové hinty tam, kde jsou užitečné pro učení
### Markdown dokumentace
- Jasná hierarchie nadpisů
- Kódové bloky s definicí jazyka
- Odkazy na doplňkové zdroje
- Snímky obrazovky a obrázky ve složkách `images/`
- Alternativní text obrázků pro přístupnost
- Jasná hierarchie nadpisů
- Bloky kódu s určením jazyka
- Odkazy na další zdroje
- Screenshoty a obrázky v adresářích `images/`
- Alt texty obrázků pro přístupnost
### Organizace souborů
- Lekce číslovány do sekvence (1-getting-started-lessons, 2-js-basics, atd.)
- Každý projekt má složky `solution/` a často `start/` nebo `your-work/`
- Obrázky uloženy v lekcích specifických složkách `images/`
- Překlady ve složkách `translations/{language-code}/`
- Lekce očíslovány postupně (1-getting-started-lessons, 2-js-basics atd.)
- Každý projekt má adresáře `solution/` a často `start/` nebo `your-work/`
- Obrázky uložené v adresářích specifických pro lekce `images/`
- Překlady ve struktuře `translations/{jazykový-kód}/`
## Build a deploy
## Sestavení a nasazení
### Nasazení Quiz App (Azure Static Web Apps)
@ -185,13 +185,13 @@ Quiz-app je nakonfigurován pro nasazení na Azure Static Web Apps:
```bash
cd quiz-app
npm run build # Vytváří složku dist/
# Nasazuje prostřednictvím workflow GitHub Actions při pushi do větve main
# Nasazuje pomocí GitHub Actions workflow při pushi do main
```
Konfigurace Azure Static Web Apps:
- **Umístění aplikace**: `/quiz-app`
- **Výstupní umístění**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
Konfigurace Azure Static Web Apps:
- **Umístění aplikace**: `/quiz-app`
- **Výstupní umístění**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Generování PDF dokumentace
@ -199,84 +199,82 @@ Konfigurace Azure Static Web Apps:
npm install # Nainstalujte docsify-to-pdf
npm run convert # Vygenerujte PDF z docs
```
### Dokumentace Docsify
```bash
npm install -g docsify-cli # Nainstalujte Docsify globálně
docsify serve # Podávejte na localhost:3000
docsify serve # Spusťte na localhost:3000
```
### Specifická sestavení projektů
### Specifické buildy projektů
Každý projektový adresář může mít vlastní build proces:
- Vue projekty: `npm run build` vytváří produkční balíčky
- Statické projekty: žádný build krok, přímo servírujte soubory
Každý projekt může mít vlastní build proces:
- Vue projekty: `npm run build` vytváří produkční balíčky
- Statické projekty: Bez build kroku, servírují přímo soubory
## Pravidla pro pull requesty
## Pokyny pro pull requesty
### Formát názvu
Používejte jasné, popisné názvy indikující oblast změny:
- `[Quiz-app] Přidat nový kvíz pro lekci X`
- `[Lesson-3] Oprava překlepu v projektu terrarium`
- `[Translation] Přidat španělský překlad pro lekci 5`
- `[Docs] Aktualizovat instrukce pro nastavení`
### Povinné kontroly
Používejte jasné, popisné názvy uvádějící oblast změny:
- `[Quiz-app] Přidání nového kvízu pro lekci X`
- `[Lesson-3] Oprava překlepu v projektu terrárium`
- `[Translation] Přidání španělského překladu pro lekci 5`
- `[Docs] Aktualizace instrukcí pro nastavení`
Před odesláním PR:
### Nutné kontroly před odesláním PR
1. **Kvalita kódu**:
- Spusťte `npm run lint` v dotčených projektových složkách
- Opravte všechny linting chyby a varování
1. **Kvalita kódu**:
- Spusťte `npm run lint` v příslušných adresářích projektů
- Opravte všechny linting chyby a varování
2. **Ověření buildu**:
- Spusťte `npm run build` je-li to relevantní
- Zajistěte žádné build chyby
2. **Ověření sestavení**:
- Spusťte `npm run build`, pokud je potřeba
- Zajistěte, že nejsou žádné chyby při sestavování
3. **Ověření odkazů**:
- Testujte všechny markdown odkazy
- Ověřte, že odkazy na obrázky fungují
3. **Ověření odkazů**:
- Otestujte všechny odkazy v markdownu
- Ověřte funkčnost obrázkových referencí
4. **Kontrola obsahu**:
- Korektura pravopisu a gramatiky
- Přesnost a vzdělávací hodnota příkladů kódu
- Přesnost a zachování smyslu překladu
4. **Kontrola obsahu**:
- Korektury pravopisu a gramatiky
- Zajistěte, že příklady kódu jsou správné a vhodné pro vzdělávání
- Ověřte přesnost překladů a zachování významu
### Požadavky na přispívání
### Požadavky na přispění
- Souhlas s Microsoft CLA (automatická kontrola u prvního PR)
- Dodržování [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Viz [CONTRIBUTING.md](./CONTRIBUTING.md) pro podrobné pokyny
- Uvádění čísel issues v popisu PR, pokud relevantní
- Souhlas s Microsoft CLA (automatická kontrola při prvním PR)
- Dodržování [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Viz [CONTRIBUTING.md](./CONTRIBUTING.md) pro podrobné pokyny
- V případě potřeby uvádějte čísla issue v popisu PR
### Proces revize
- PR revidují správci a komunita
- Priorita na srozumitelnost pro vzdělávání
- Příklady kódu by měly reflektovat aktuální osvědčené postupy
- Překlady revidovány pro přesnost a kulturní vhodnost
- PR jsou kontrolovány správci a komunitou
- Převládá vzdělávací srozumitelnost
- Příklady kódu by měly odpovídat aktuálním nejlepším praktikám
- Překlady jsou kontrolovány z hlediska přesnosti a kulturní vhodnosti
## Překladový systém
### Automatický překlad
### Automatizovaný překlad
- Používá GitHub Actions s workflow co-op-translator
- Překlad do více než 50 jazyků automaticky
- Zdrojové soubory v hlavních adresářích
- Přeložené soubory v `translations/{language-code}/`
- Používá GitHub Actions s workflow co-op-translator
- Automatický překlad do více než 50 jazyků
- Zdrojové soubory v hlavních adresářích
- Přeložené soubory v adresářích `translations/{jazykový-kód}/`
### Přidávání ručních překladových vylepšení
### Přidávání manuálních zlepšení překladů
1. Najděte soubor v `translations/{language-code}/`
2. Proveďte úpravy se zachováním struktury
3. Ujistěte se, že příklady kódu fungují
4. Testujte jakýkoli lokalizovaný kvízový obsah
1. Najděte soubor v `translations/{jazykový-kód}/`
2. Provádějte zlepšení s zachováním struktury
3. Zajistěte funkčnost příkladů kódu
4. Testujte lokalizovaný obsah kvízů
### Metadata překladu
Přeložené soubory obsahují hlavičku s metadata:
Přeložené soubory obsahují metadata hlavičku:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -288,121 +286,121 @@ CO_OP_TRANSLATOR_METADATA:
}
-->
```
## Ladění a řešení problémů
### Běžné problémy
**Quiz app nelze spustit**:
- Zkontrolujte verzi Node.js (doporučeno v14+)
- Smažte `node_modules` a `package-lock.json`, spusťte `npm install` znovu
- Zkontrolujte konflikty portů (standardně Vite používá port 5173)
**Quiz app se nespustí**:
- Zkontrolujte verzi Node.js (doporučeno v14+)
- Smažte `node_modules` a `package-lock.json`, spusťte `npm install` znovu
- Zkontrolujte konflikty portů (výchozí: Vite používá port 5173)
**API server se nespustí**:
- Ověřte, že verze Node.js splňuje minimum (node >=10)
- Zkontrolujte, zda port není již obsazený
- Zajistěte, že všechny závislosti jsou nainstalovány (`npm install`)
**API server se nespustí**:
- Ověřte, že Node.js má minimálně verzi (node >=10)
- Zkontrolujte, zda port není již obsazen
- Ujistěte se, že jsou nainstalovány všechny závislosti pomocí `npm install`
**Rozšíření prohlížeče se nenačte**:
- Ověřte správné formátování manifest.json
- Podívejte se do konzole prohlížeče na chyby
- Dodržujte instrukce pro instalaci podle prohlížeče
**Rozšíření prohlížeče se nenačte**:
- Ověřte správné formátování manifest.json
- Zkontrolujte chyby v konzoli prohlížeče
- Postupujte podle pokynů pro instalaci rozšíření specifických pro prohlížeč
**Problémy s Python chat projektem**:
- Ujistěte se, že je nainstalován balíček OpenAI: `pip install openai`
- Ověřte nastavení prostředí proměnné GITHUB_TOKEN
- Zkontrolujte přístupová oprávnění GitHub Models
**Problémy s Python chat projektem**:
- Ujistěte se, že je nainstalován balíček OpenAI: `pip install openai`
- Přesvědčte se, že proměnná prostředí GITHUB_TOKEN je nastavena
- Ověřte přístupová oprávnění k GitHub Models
**Docsify neslouží dokumentaci**:
- Nainstalujte docsify-cli globálně: `npm install -g docsify-cli`
- Spusťte z kořenového adresáře repozitáře
- Zkontrolujte, že `docs/_sidebar.md` existuje
**Docsify neservíruje dokumentaci**:
- Nainstalujte globálně docsify-cli: `npm install -g docsify-cli`
- Spusťte z kořenového adresáře repozitáře
- Zkontrolujte, že existuje soubor `docs/_sidebar.md`
### Tipy pro vývojové prostředí
- Používejte VS Code s rozšířením Live Server pro HTML projekty
- Nainstalujte ESLint a Prettier pro konzistentní formátování
- Používejte DevTools v prohlížeči pro ladění JavaScriptu
- Pro Vue projekty nainstalujte Vue DevTools rozšíření prohlížeče
- Používejte VS Code s rozšířením Live Server pro HTML projekty
- Nainstalujte ESLint a Prettier rozšíření pro konzistentní formátování
- Používejte DevTools v prohlížeči pro ladění JavaScriptu
- Pro Vue projekty nainstalujte Vue DevTools rozšíření do prohlížeče
### Výkonové aspekty
- Velký počet přeložených souborů (50+ jazyků) znamená, že každý plný klon je velký
- Používejte shallow clone při práci jen s obsahem: `git clone --depth 1`
- Vylučujte překlady z vyhledávání při práci na anglickém obsahu
- Build procesy mohou být pomalé při prvním spuštění (npm install, Vite build)
- Velké množství přeložených souborů (50+ jazyků) znamená velké plné klony
- Používejte shallow clone, pokud pracujete pouze s obsahem: `git clone --depth 1`
- Vyjměte překlady z vyhledávání při práci s anglickým obsahem
- Build procesy mohou být pomalé při prvním spuštění (npm install, Vite build)
## Bezpečnostní aspekty
### Proměnné prostředí
- API klíče by nikdy neměly být commitovány do repozitáře
- Používejte `.env` soubory (jsou již zahrnuty v `.gitignore`)
- Dokumentujte požadované proměnné prostředí v README projektech
- API klíče by nikdy neměly být commitovány do repozitáře
- Používejte `.env` soubory (již v `.gitignore`)
- Požadované proměnné dokumentujte v README projektů
### Python projekty
- Používejte virtuální prostředí: `python -m venv venv`
- Udržujte závislosti aktuální
- GitHub tokeny by měly mít minimální potřebná oprávnění
- Používejte virtuální prostředí: `python -m venv venv`
- Udržujte závislosti aktuální
- GitHub tokeny by měly mít minimální potřebná oprávnění
### Přístup k GitHub Models
- Osobní přístupové tokeny (PAT) jsou vyžadovány pro GitHub Models
- Tokeny ukládejte jako proměnné prostředí
- Nikdy necommitujte tokeny nebo přihlašovací údaje
- Pro GitHub Models jsou potřeba osobní přístupové tokeny (PAT)
- Tokeny ukládejte jako proměnné prostředí
- Nikdy necommitujte tokeny nebo přihlašovací údaje
## Další poznámky
### Cílová skupina
- Kompletní začátečníci ve webovém vývoji
- Studenti a samouci
- Učitelé používající kurikulum ve třídách
- Obsah je navržen pro přístupnost a postupné budování dovedností
- Úplní začátečníci ve webovém vývoji
- Studenti a samouci
- Učitelé používající kurikulum ve třídách
- Obsah je navržen s důrazem na přístupnost a postupné budování dovedností
### Vzdělávací filozofie
- Přístup založený na projektech
- Časté kontroly znalostí (kvízy)
- Praktické cvičení v kódování
- Příklady reálných aplikací
- Důraz na základy před rámcemi
- Přístup založený na projektech
- Časté prověřování znalostí (kvízy)
- Praktická cvičení s kódováním
- Příklady aplikací z reálného světa
- Zaměření na základy před frameworky
### Údržba repozitáře
- Aktivní komunita studentů a přispěvatelů
- Pravidelné aktualizace závislostí a obsahu
- Správci monitorují issues a diskuze
- Aktualizace překladů automatizovány přes GitHub Actions
- Aktivní komunita studentů a přispěvatelů
- Pravidelné aktualizace závislostí a obsahu
- Sledování issue a diskuzí správci
- Automatizované aktualizace překladů pomocí GitHub Actions
### Související zdroje
- [Microsoft Learn moduly](https://docs.microsoft.com/learn/)
- [Student Hub zdroje](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) doporučený pro studenty
- Další kurzy: Generativní AI, Data Science, ML, IoT kurikula dostupná
- [Microsoft Learn moduly](https://docs.microsoft.com/learn/)
- [Student Hub zdroje](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) doporučený pro studenty
- Další kurzy: Generativní AI, Data Science, ML, IoT kurikula dostupná
### Práce se specifickými projekty
### Práce s konkrétními projekty
Pro podrobné instrukce k jednotlivým projektům viz README soubory v:
- `quiz-app/README.md` - Vue 3 quiz aplikace
- `7-bank-project/README.md` - Bankovní aplikace s autentizací
- `5-browser-extension/README.md` - Vývoj rozšíření prohlížeče
- `6-space-game/README.md` - Vývoj her na canvasu
- `9-chat-project/README.md` - Projekt AI chat asistenta
Pro podrobné instrukce k jednotlivým projektům viz README soubory v:
- `quiz-app/README.md` - Vue 3 quiz aplikace
- `7-bank-project/README.md` - Bankovní aplikace s autentifikací
- `5-browser-extension/README.md` - Vývoj rozšíření prohlížeče
- `6-space-game/README.md` - Vývoj hry v Canvasu
- `9-chat-project/README.md` - Projekt AI chat asistenta
### Struktura monorepo
### Struktura monorepa
I když to není tradiční monorepo, tento repozitář obsahuje více nezávislých projektů:
- Každá lekce je samostatná
- Projekty nesdílejí závislosti
- Pracujte na jednotlivých projektech bez ovlivnění ostatních
- Naklonujte celý repozitář pro kompletní zážitek kurikula
I když nejde o tradiční monorepo, tento repozitář obsahuje několik nezávislých projektů:
- Každá lekce je soběstačná
- Projekty nesdílí závislosti
- Pracujte na jednotlivých projektech bez ovlivnění ostatních
- Naklonujte celý repozitář pro kompletní zkušenost s kurikulem
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Prohlášení o vyloučení odpovědnosti**:
Tento dokument byl přeložen pomocí služeb automatického překladu AI [Co-op Translator](https://github.com/Azure/co-op-translator). I když usilujeme o přesnost, mějte prosím na paměti, že automatické překlady mohou obsahovat chyby nebo nepřesnosti. Původní dokument v jeho mateřském jazyce by měl být považován za autoritativní zdroj. Pro kritické informace se doporučuje profesionální lidský překlad. Nejsme odpovědni za případné nedorozumění nebo chybnou interpretaci vzniklou použitím tohoto překladu.
**Prohlášení o vyloučení odpovědnosti**:
Tento dokument byl přeložen pomocí služby automatického překladu AI [Co-op Translator](https://github.com/Azure/co-op-translator). Přestože usilujeme o přesnost, mějte prosím na paměti, že automatizované překlady mohou obsahovat chyby nebo nepřesnosti. Originální dokument v jeho rodném jazyce by měl být považován za závazný zdroj. Pro zásadní informace se doporučuje profesionální lidský překlad. Nejsme odpovědní za jakákoliv nedorozumění nebo špatné výklady vzniklé z používání tohoto překladu.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

2
translations/hu/.co-op-translator.json
Unescape View File

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T11:51:34+00:00",
"translation_date": "2026-02-06T13:18:07+00:00",
"source_file": "AGENTS.md",
"language_code": "hu"
},

334
translations/hu/AGENTS.md
Unescape View File

@ -1,43 +1,43 @@
# AGENTS.md
## Projekt áttekintése
## Projekt áttekintés
Ez egy oktatási tananyag-tár, amely kezdőknek szóló webfejlesztési alapok oktatására szolgál. A tananyag egy átfogó, 12 hetes kurzus, amelyet a Microsoft Cloud Advocates fejlesztett ki, és 24 gyakorlati leckét tartalmaz JavaScript, CSS és HTML témakörökben.
Ez egy oktatási tantervi tárhely, amely a webfejlesztés alapjainak kezdőknek történő tanítására szolgál. A tanterv egy átfogó, 12 hetes kurzus, amelyet a Microsoft Cloud Advocates fejlesztett ki, és 24 gyakorlati leckét tartalmaz, amelyek lefedik a JavaScript, CSS és HTML témaköröket.
### Fő összetevők
- **Oktatási tartalom**: 24 strukturált lecke projektalapú modulokba rendezve
- **Gyakorlati projektek**: Terrárium, gépelős játék, böngészőbővítmény, űr játék, banki alkalmazás, kódszerkesztő, és AI csevegősegéd
- **Interaktív kvízek**: 48 kvíz, mindegyik 3 kérdéssel (leckék előtti/utáni értékelés)
- **Többnyelvű támogatás**: Automatikus fordítás több mint 50 nyelvre GitHub Actions által
- **Oktatási tartalom**: 24 strukturált lecke projektalapú modulokban
- **Gyakorlati projektek**: Terrárium, gépelős játék, böngészőbővítmény, űrjáték, banki alkalmazás, kódszerkesztő és AI chat asszisztens
- **Interaktív kvízek**: 48 kvíz, egyenként 3 kérdéssel (elő- és utóleckés értékelések)
- **Többnyelvű támogatás**: Automatikus fordítás 50+ nyelvre GitHub Actions segítségével
- **Technológiák**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI projektekhez)
### Architektúra
- Oktatási tár leckékre bontott szerkezettel
- Minden lecke mappája tartalmaz README-t, kódpéldákat és megoldásokat
- Önálló projektek külön könyvtárakban (quiz-app, különböző lecke projektek)
- Fordító rendszer GitHub Actions-szel (co-op-translator)
- Dokumentáció Docsify-val szolgáltatva és PDF formátumban elérhető
- Oktatási tárhely leckék szerinti struktúrával
- Minden lecke mappában README, kódpéldák és megoldások találhatók
- Külön projektek külön mappákban (quiz-app, különféle lecke projektek)
- Fordítási rendszer GitHub Actions-al (co-op-translator)
- Dokumentáció Docsify segítségével, PDF-ben is elérhető
## Beállítási parancsok
Ez a tár elsősorban oktatási tartalom fogyasztására szolgál. Specifikus projektekkel való munkához:
Ez a tárhely elsősorban oktatási tartalom fogyasztására szolgál. Konkrét projektekkel való munka esetén:
### Fő tár beállítás
### Fő tárhely beállítása
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### Kvíz alkalmazás beállítása (Vue 3 + Vite)
### Quiz App beállítása (Vue 3 + Vite)
```bash
cd quiz-app
npm install
npm run dev # Fejlesztői szerver indítása
npm run build # Építés éles környezethez
npm run build # Éles verzió készítése
npm run lint # ESLint futtatása
```
@ -46,8 +46,8 @@ npm run lint # ESLint futtatása
```bash
cd 7-bank-project/api
npm install
npm start # API szerver indítása
npm run lint # ESLint futtatása
npm start # Indítsa el az API szervert
npm run lint # Futtassa az ESLint-et
npm run format # Formázás Prettier-rel
```
@ -56,18 +56,18 @@ npm run format # Formázás Prettier-rel
```bash
cd 5-browser-extension/solution
npm install
# Kövesse a böngészőspecifikus bővítmény betöltési utasításait
# Kövesse a böngészőspecifikus bővítménybetöltési utasításokat
```
### Űr játék projektek
### Űrjáték projektek
```bash
cd 6-space-game/solution
npm install
# Nyissa meg az index.html fájlt a böngészőben vagy használja a Live Server-t
# Nyisd meg az index.html fájlt a böngészőben vagy használd a Live Server-t
```
### Csevegőprojekt (Python backend)
### Chat projekt (Python backend)
```bash
cd 9-chat-project/solution/backend/python
@ -78,39 +78,39 @@ python api.py
## Fejlesztési munkafolyamat
### Tartalomhozzájárulók számára
### Tartalomszolgáltatók számára
1. **Válaszd le a tárat** a saját GitHub fiókodba
2. **Klónozd le a saját forkodat** helyileg
3. **Hozz létre egy új ágat** a változtatásaidnak
4. Végezz módosításokat a lecke tartalmakban vagy kódpéldákban
5. Teszteld a kódbeli változtatásokat a releváns projektkönyvtárakban
6. Küldd be a kérésed a hozzájárulási irányelvek szerint
1. **Forkold a tárhelyet** a GitHub fiókodba
2. **Klonozd le a forkot** helyileg
3. **Hozz létre egy új ágat** a változtatásaidhoz
4. Végezze el a leckék vagy kódpéldák módosítását
5. Teszteld a kódváltoztatásokat az érintett projektmappákban
6. Küldj pull requesteket a hozzájárulási irányelvek szerint
### Tanulók számára
1. Forkold vagy klónozd le a tárat
2. Sorban haladj a lecke mappákban
1. Forkold vagy klónozd le a tárhelyet
2. Lépj sorban a lecke mappákba
3. Olvasd el az egyes leckék README fájljait
4. Teljesítsd a leckék előtti kvízeket az https://ff-quizzes.netlify.app/web/ oldalon
5. Dolgozz a lecke mappák kódpéldáin
6. Készítsd el a feladatokat és kihívásokat
7. Tedd meg a post-lecke kvízeket
4. Töltsd ki a leckék előtti kvízeket a https://ff-quizzes.netlify.app/web/ oldalon
5. Dolgozd át a kódpéldákat a lecke mappákban
6. Teljesítsd a feladatokat és kihívásokat
7. Töltsd ki az utóleckés kvízeket
### Élő fejlesztés
- **Dokumentáció**: Futtasd a `docsify serve` parancsot a gyökérben (3000-es port)
- **Kvíz alkalmazás**: Futtasd a `npm run dev` parancsot a quiz-app mappában
- **Projektek**: Használd a VS Code Live Server bővítményt HTML projektekhez
- **API projektek**: Futtasd a `npm start` parancsot a megfelelő API könyvtárakban
- **Dokumentáció**: Futtasd a `docsify serve` parancsot a gyökérben (port 3000)
- **Quiz App**: Futtasd az `npm run dev` parancsot a quiz-app mappában
- **Projektek**: Használj VS Code Live Server bővítményt HTML projektekhez
- **API projektek**: Futtasd az `npm start` parancsot az adott API mappákban
## Tesztelési útmutató
### Kvíz alkalmazás tesztelése
### Quiz App tesztelése
```bash
cd quiz-app
npm run lint # Ellenőrizze a kódstílus problémákat
npm run lint # Ellenőrizze a kódstílus-problémákat
npm run build # Ellenőrizze, hogy a build sikeres-e
```
@ -124,159 +124,159 @@ node server.js # Ellenőrizze, hogy a szerver hiba nélkül indul-e
### Általános tesztelési megközelítés
- Ez egy oktatási tár, nem tartalmaz teljes automatizált teszteket
- Manuális tesztelés fókuszában:
- Kód példák futtatása hibamentesen
- Dokumentációban lévő linkek megfelelő működése
- Projektek sikeres lefordítása
- Példák a legjobb gyakorlatok betartásával
- Ez egy oktatási tárhely, nincs átfogó automatizált tesztelés
- Kézi tesztelés fókuszai:
- Kódpéldák futtatása hibák nélkül
- Dokumentáció hivatkozások működése
- Projektek sikeres buildelése
- Példák legjobb gyakorlatok betartása
### Beküldés előtti ellenőrzés
### Beküldés előtti ellenőrzések
- Futtasd az `npm run lint` parancsot a package.json fájlt tartalmazó mappákban
- Ellenőrizd a markdown linkeket, hogy érvényesek-e
- Teszteld a kód példákat böngészőben vagy Node.js-ben
- Bizonyosodj meg róla, hogy a fordítások megtartják az eredeti struktúrát
- Futtasd az `npm run lint` parancsot a package.json-t tartalmazó mappákban
- Ellenőrizd a markdown hivatkozásokat
- Teszteld a kódpéldákat böngészőben vagy Node.js-ben
- Ellenőrizd, hogy a fordítások megőrzik a megfelelő struktúrát
## Kódstílus irányelvek
### JavaScript
- Használj modern ES6+ szintaxist
- Kövesd a projektekben definiált alap ESLint beállításokat
- Használj érthető változó- és függvényneveket az oktatási érthetőség érdekében
- Kommentáld a koncepciókat a tanulók számára
- Formázd Prettier-rel, ahol van konfigurálva
- Kövesd az ESLint szabályokat, amelyeket a projektek tartalmaznak
- Használj értelmes változó- és függvényneveket az oktatási érthetőségért
- Tegyél megjegyzéseket az elképzelések magyarázatára a tanulók számára
- Formázd Prettier-rel, ahol be van állítva
### HTML/CSS
- Szemantikus HTML5 elemek
- Reszponzív tervezési elvek
- Egyértelmű osztályelnevezések
- Kommentek a CSS technikák magyarázatához tanulók számára
- Szemiantikus HTML5 elemek használata
- Reszponzív dizájn elvei
- Egyértelmű osztályelnevezési szabályok
- Megjegyzések a CSS technikákról a tanulók számára
### Python
- PEP 8 stílus irányelvek
- Tiszta, oktatási kód példák
- Típusjelzések, ahol hasznosak a tanuláshoz
- PEP 8 stílusirányelvek betartása
- Tiszta, oktatási kódpéldák
- Típusjelölések, ahol a tanulást segítik
### Markdown dokumentáció
- Áttekinthető címsor hierarchia
- Kódblokkok nyelvi megjelöléssel
- Hivatkozások további erőforrásokra
- Képernyőkép és képek az `images/` mappákban
- Alt szöveg a képekhez az akadálymentességért
- Egyértelmű címsorszintek
- Kódblokkok nyelvi specifikációval
- Hivatkozások további forrásokra
- Képernyőképek és képek az `images/` mappákban
- Alt szöveg a képekhez akadálymentesség miatt
### Fájlszervezés
### Fájlok rendszerezése
- Leckék számozva egymás után (1-getting-started-lessons, 2-js-basics stb.)
- Minden projektnek vannak `solution/`, és gyakran `start/` vagy `your-work/` mappái
- Képek a lecke specifikus `images/` mappákban tárolva
- Leckék számozva egymás után (pl. 1-getting-started-lessons, 2-js-basics stb.)
- Minden projektnek van `solution/` és gyakran `start/` vagy `your-work/` mappája
- Képek a lecke-specifikus `images/` mappákban
- Fordítások a `translations/{language-code}/` struktúrában
## Build és telepítés
### Kvíz alkalmazás telepítése (Azure Static Web Apps)
### Quiz App telepítése (Azure Static Web Apps)
A kvíz-app Azure Static Web Apps telepítéshez konfigurált:
A quiz-app Azure Static Web Apps szolgáltatásra van konfigurálva:
```bash
cd quiz-app
npm run build # Létrehozza a dist/ mappát
# Telepítés GitHub Actions munkafolyamaton keresztül a main ágra történő push esetén
# GitHub Actions munkafolyamattal telepít a main ágra történő push esetén
```
Azure Static Web Apps beállítással:
- **Alkalmazás helye**: `/quiz-app`
Azure Static Web Apps beállítások:
- **App helye**: `/quiz-app`
- **Kimeneti hely**: `dist`
- **Munkafolyamat**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
- **Folyamat**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Dokumentáció PDF generálás
```bash
npm install # Telepítse a docsify-to-pdf csomagot
npm run convert # PDF generálása a docs-ból
npm install # docsify-to-pdf telepítése
npm run convert # PDF generálása a docs alapján
```
### Docsify dokumentáció
```bash
npm install -g docsify-cli # Telepítse a Docsify-t globálisan
docsify serve # Szolgáltatás futtatása a localhost:3000 címen
docsify serve # Szolgáltatás localhost:3000 címen
```
### Projekt-specifikus build folyamatok
### Projektspecifikus build folyamatok
Minden projekt könyvtárában lehet saját build folyamat:
- Vue projektek: `npm run build` gyártási csomagokat hoz létre
- Statikus projektek: nincs build lépés, fájlokat közvetlenül szolgáltatja
Minden projekt mappának lehet saját build folyamata:
- Vue projektek: `npm run build` létrehozza az éles csomagokat
- Statikus projektek: nincs build lépés, a fájlokat direkt szolgáljuk ki
## Pull Request irányelvek
## Pull request irányelvek
### Cím formátum
### Címformátum
Használj világos, leíró címeket, amelyek mutatják a változtatás területét:
Használj világos, leíró címeket, melyek jelzik a változtatás területét:
- `[Quiz-app] Új kvíz hozzáadása az X. leckéhez`
- `[Lesson-3] Elírás javítása terrárium projektben`
- `[Lesson-3] Elírás javítása a terrárium projektben`
- `[Translation] Spanyol fordítás hozzáadása az 5. leckéhez`
- `[Docs] Beállítási utasítások frissítése`
- `[Docs] Beállítási útmutató frissítése`
### Kötelező ellenőrzések
PR beküldése előtt:
1. **Kódminőség**:
- Futtasd az `npm run lint` parancsot az érintett projektkönyvtárakban
- Futtasd az `npm run lint` parancsot az érintett projektmappákban
- Javítsd az összes lint hibát és figyelmeztetést
2. **Build ellenőrzés**:
- Futtasd az `npm run build` parancsot, ha alkalmazható
- Bizonyosodj meg arról, hogy nincs build hiba
- Futtasd az `npm run build` parancsot, ha van ilyen
- Győződj meg, hogy nincs build hiba
3. **Link validálás**:
3. **Linkek ellenőrzése**:
- Teszteld az összes markdown linket
- Ellenőrizd a képhivatkozások működését
- Ellenőrizd a képek hivatkozásait
4. **Tartalom átnézés**:
4. **Tartalom átvizsgálása**:
- Ellenőrizd helyesírást és nyelvtant
- Győződj meg róla, hogy a kód példák helyesek és oktatók
- Ellenőrizd a fordítások helyességét és eredeti jelentés megtartását
- Győződj meg, hogy a kódpéldák helyesek és oktatók
- Ollózkodj meg a fordítások megfelelőségéről
### Hozzájárulási követelmények
### Hozzájárulási feltételek
- Fogadd el a Microsoft CLA-t (automatikus ellenőrzés az első PR-nál)
- Kövesd a [Microsoft nyílt forráskódú magatartási kódexét](https://opensource.microsoft.com/codeofconduct/)
- Lásd a [CONTRIBUTING.md](./CONTRIBUTING.md) fájlt részletes útmutatásért
- Hivatkozz az issue számokra a PR leírásában, ha releváns
- Fogadd el a Microsoft CLA-t (automatikusan ellenőrzik az első PR-nál)
- Kövesd a [Microsoft Open Source Kódex](https://opensource.microsoft.com/codeofconduct/) szabályait
- Részletekért lásd a [CONTRIBUTING.md](./CONTRIBUTING.md) fájlt
- Amennyiben van, hivatkozz PR leírásban issue számokra
### Felülvizsgálati folyamat
### Áttekintési folyamat
- PR-eket karbantartók és a közösség nézi át
- Oktatási érthetőség az elsődleges szempont
- A PR-ket karbantartók és közösség vizsgálja
- Oktatási érthetőség prioritás
- Kódpéldák kövessék a jelenlegi legjobb gyakorlatokat
- Fordításokat pontosság és kulturális megfelelőség szerint ellenőrzik
- Fordításokat átvizsgálják pontosság és kulturális megfelelőség szempontjából
## Fordító rendszer
## Fordítási rendszer
### Automatikus fordítás
- GitHub Actions használatával co-op-translator munkafolyamat
- GitHub Actions használ co-op-translator munkafolyamatot
- Több mint 50 nyelvre automatikus fordítás
- Forrásfájlok a fő könyvtárakban
- Fordított fájlok a `translations/{language-code}/` könyvtárakban
### Manuális fordítási javítások hozzáadása
1. Keresd meg a fájlt a `translations/{language-code}/` könyvtárban
2. Javíts a szövegen a struktúra megtartásával
3. Gondoskodj róla, hogy a kódpéldák működjenek továbbra is
4. Teszteld az esetleges lokalizált kvíz tartalmat
1. Keresd meg a fájlt a `translations/{language-code}/` mappában
2. Javítsd miközben megtartod a struktúrát
3. Biztosítsd, hogy a kódpéldák továbbra is működnek
4. Teszteld az adott nyelvű kvíz tartalmakat
### Fordítási metaadatok
### Fordítás metaadatok
A fordított fájlok metaadat fejlécet tartalmaznak:
A fordított fájlok tartalmaznak metaadat fejlécet:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -289,77 +289,77 @@ CO_OP_TRANSLATOR_METADATA:
-->
```
## Hibakeresés és hibaelhárítás
## Hibakeresés és problémaelhárítás
### Gyakoribb problémák
### Gyakori problémák
**A kvíz alkalmazás nem indul**:
**Quiz app nem indul el**:
- Ellenőrizd a Node.js verziót (ajánlott v14+)
- Töröld a `node_modules` és `package-lock.json` fájlokat, majd futtasd újra az `npm install`-t
- Ellenőrizd a port ütközést (alapértelmezett: Vite port 5173)
- Töröld a `node_modules` és `package-lock.json` fájlokat, majd futtasd újra az `npm install` parancsot
- Ellenőrizd, hogy nincs port ütközés (alapértelmezett port: Vite használja az 5173-at)
**API szerver nem indul**:
- Ellenőrizd a Node.js minimum verziót (node >=10)
- Nézd meg, hogy a port nincs-e használatban
- Győződj meg róla, hogy minden függőség telepítve van az `npm install` után
- Ellenőrizd a Node.js verzióját (node >=10 minimum)
- Nézd meg, hogy a port nincs-e már használatban
- Győződj meg róla, hogy az összes függőség telepítve van az `npm install` által
**Böngészőbővítmény nem töltődik be**:
- Ellenőrizd, hogy a manifest.json megfelelő formátumú-e
- Nézd át a böngésző konzolját hibákért
- Kövesd a böngésző-specifikus bővítmény telepítési útmutatót
- Ellenőrizd a manifest.json helyes formázását
- Nézd meg a böngésző konzolját hibák után
- Kövesd a böngészőspecifikus bővítmény telepítési utasításokat
**Python csevegőprojektnél problémák**:
- Ellenőrizd, hogy az OpenAI csomag telepítve van-e: `pip install openai`
- Győződj meg róla, hogy a GITHUB_TOKEN környezeti változó be van állítva
- Nézd meg a GitHub Modellekhez való hozzáférési jogosultságokat
**Python chat projekt problémák**:
- Győződj meg róla, hogy az OpenAI csomag telepítve van: `pip install openai`
- Ellenőrizd, hogy a GITHUB_TOKEN környezeti változó be van állítva
- Ellenőrizd a GitHub Models hozzáférési engedélyeket
**Docsify nem szolgáltat dokumentációt**:
- Telepítsd globálisan a docsify-cli-t: `npm install -g docsify-cli`
- Futtasd a tár gyökeréből
- Ellenőrizd, hogy a `docs/_sidebar.md` létezik
- A tárhely gyökeréből futtasd
- Ellenőrizd, hogy a `docs/_sidebar.md` fájl létezik
### Fejlesztői környezeti tippek
### Fejlesztési környezeti tippek
- Használd a VS Code Live Server bővítményét HTML projektekhez
- Telepíts ESLint és Prettier bővítményeket az egységes formázáshoz
- Használj VS Code Live Server bővítményt HTML projektekhez
- Telepítsd az ESLint és Prettier bővítményeket az egységes formázáshoz
- Használd a böngésző DevTools-t JavaScript hibakereséshez
- Vue projektekhez telepítsd a Vue DevTools böngészőbővítményt
### Teljesítmény szempontok
- Nagyszámú fordított fájl (50+ nyelv) miatt a teljes klónozás nagy méretű
- Használj sekély klónozást, ha csak a tartalmon dolgozol: `git clone --depth 1`
- Fordításokat ne keresd át angol tartalom szerkesztésekor
- Build folyamatok lassúak lehetnek első futtatáskor (npm install, Vite build)
- A sok fordított fájl (50+ nyelv) miatt a teljes klón nagy méretű
- Használj sekély klónt, ha csak tartalmakkal dolgozol: `git clone --depth 1`
- Angol tartalmon dolgozáskor zárd ki a fordításokat a keresésekből
- Build folyamatok lassúak lehetnek az első futtatáskor (npm install, Vite build)
## Biztonsági szempontok
### Környezeti változók
- API kulcsokat soha ne kövess a tárba
- Használj `.env` fájlokat (már a `.gitignore`-ban vannak)
- Dokumentáld a szükséges környezeti változókat a projekt README-jeiben
- API kulcsokat soha ne tölts fel a tárhelyre
- Használj `.env` fájlokat (amelyek `.gitignore`-ba vannak véve)
- Dokumentáld a szükséges környezeti változókat a projekt README-kben
### Python projektek
- Használj virtuális környezetet: `python -m venv venv`
- Használj virtuális környezeteket: `python -m venv venv`
- Tartsd naprakészen a függőségeket
- GitHub tokeneknek csak minimálisan szükséges jogosultságokat adj
- A GitHub tokeneknek minimális jogosultságokkal kell rendelkezniük
### GitHub Modellekhez való hozzáférés
### GitHub Models hozzáférés
- Személyes hozzáférési tokenek (PAT) szükségesek a GitHub Modellekhez
- Személyes hozzáférési tokenek (PAT) szükségesek a GitHub Models használatához
- A tokeneket környezeti változóként tárold
- Soha ne kövesd be a tokeneket vagy hitelesítő adatokat
- Tokeneket vagy hitelesítő adatokat soha ne tölts fel
## Egyéb megjegyzések
### Célközönség
- Teljes kezdők a webfejlesztésben
- Tanulók és önálló tanulók
- Tanárok, akik osztálytermekben használják a tananyagot
- A tartalom akadálymentességhez és fokozatos készségepítéshez készült
- Teljesen kezdő webfejlesztők
- Diákok és önálló tanulók
- Tanárok, akik az órákon használják a tananyagot
- A tartalom akadálymentességre és fokozatos készségfejlesztésre lett tervezve
### Oktatási filozófia
@ -367,42 +367,42 @@ CO_OP_TRANSLATOR_METADATA:
- Gyakori tudásellenőrzések (kvízek)
- Gyakorlati kódolási feladatok
- Valós alkalmazási példák
- Az alapokra fókuszálás a keretrendszerek előtt
- Alapokra fókuszálás a keretrendszerek előtt
### Tár karbantartás
### Tárhely karbantartás
- Aktív tanulói és hozzájárulói közösség
- Rendszeres frissítések függőségekben és tartalomban
- Issue-k és beszélgetések figyelemmel kísérése karbantartók által
- Fordítás frissítések automatizálva GitHub Actions által
- Aktív közösség tanulókból és hozzájárulókból
- Függőségek és tartalom rendszeres frissítése
- Issue-k és viták karbantartói felügyelettel
- Fordítási frissítések automatizáltak GitHub Actions segítségével
### Kapcsolódó források
- [Microsoft Learn modulok](https://docs.microsoft.com/learn/)
- [Student Hub erőforrások](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) ajánlott tanulóknak
- Egyéb kurzusok: Generative AI, Data Science, ML, IoT tananyagok elérhetők
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) ajánlott a tanulóknak
- További kurzusok: Generatív AI, Adattudomány, ML, IoT tantervek elérhetők
### Specifikus projektekkel való munka
### Konkrét projektek kezelése
Részletes útmutató egyes projektekhez a README fájlokban:
- `quiz-app/README.md` - Vue 3 alapú kvíz alkalmazás
- `7-bank-project/README.md` - Banki alkalmazás autentikációval
Részletes utasítások az egyes projektekhez a README fájlokban:
- `quiz-app/README.md` - Vue 3 kvíz alkalmazás
- `7-bank-project/README.md` - Banki alkalmazás hitelesítéssel
- `5-browser-extension/README.md` - Böngészőbővítmény fejlesztés
- `6-space-game/README.md` - Vászon alapú játék fejlesztés
- `9-chat-project/README.md` - AI csevegősegéd projekt
- `9-chat-project/README.md` - AI chat asszisztens projekt
### Monorepo szerkezet
Bár nem hagyományos monorepóról van szó, ez a tár több önálló projektet tartalmaz:
Bár nem hagyományos monorepo, ez a tárhely több független projektet tartalmaz:
- Minden lecke önálló
- A projektek nem osztanak meg függőségeket
- Egyéni projekteken dolgozz anélkül, hogy a többire hatnál
- Klónozd az egész tárat a teljes tanulási élményért
- Egyes projekteken dolgozhatsz anélkül, hogy másokat érintenél
- Teljes tantervélményhez klónozd az egész tárhelyet
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Jogi nyilatkozat**:
Ezt a dokumentumot az AI fordítószolgáltatás, a [Co-op Translator](https://github.com/Azure/co-op-translator) használatával fordítottuk le. Bár a pontosságra törekszünk, kérjük, vegye figyelembe, hogy az automatikus fordítások tartalmazhatnak hibákat vagy pontatlanságokat. Az eredeti dokumentum a saját nyelvén tekintendő hiteles forrásnak. Kritikus információk esetén szakmai emberi fordítást javaslunk. Nem vállalunk felelősséget a fordítás használatából eredő félreértésekért vagy félreértelmezésekért.
Ezt a dokumentumot a [Co-op Translator](https://github.com/Azure/co-op-translator) AI fordító szolgáltatás segítségével fordítottuk. Habár törekszünk a pontosságra, kérjük, vegye figyelembe, hogy az automatikus fordítások hibákat vagy pontatlanságokat tartalmazhatnak. Az eredeti dokumentum anyanyelvű változata tekintendő hivatalos forrásnak. Fontos információk esetén professzionális, emberi fordítást javasolunk. Nem vállalunk felelősséget semmilyen félreértésért vagy félrepontozásért, amely ebből a fordításból ered.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

2
translations/sk/.co-op-translator.json
Unescape View File

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T11:53:58+00:00",
"translation_date": "2026-02-06T13:20:37+00:00",
"source_file": "AGENTS.md",
"language_code": "sk"
},

428
translations/sk/AGENTS.md
Unescape View File

@ -2,27 +2,27 @@
## Prehľad projektu
Toto je vzdelávací repozitár pre výučbu základov webového vývoja pre začiatočníkov. Kurz je komplexný 12-týždňový program vyvinutý Microsoft Cloud Advocates, obsahujúci 24 praktických lekcií zameraných na JavaScript, CSS a HTML.
Toto je vzdelávací repozitár kurikula na výučbu základov webového vývoja pre začiatočníkov. Kurikulum je komplexný 12-týždňový kurz vyvinutý Microsoft Cloud Advocates, ktorý obsahuje 24 praktických lekcií pokrývajúcich JavaScript, CSS a HTML.
### Kľúčové komponenty
### Kľúčové súčasti
- **Vzdelávací obsah**: 24 štruktúrovaných lekcií organizovaných do modulov založených na projektoch
- **Praktické projekty**: Terrárium, Hra na písanie, Rozšírenie prehliadača, Hra v priestore, Banková aplikácia, Editor kódu a AI Chat asistent
- **Interaktívne kvízy**: 48 kvízov so 3 otázkami v každom (testy pred a po lekcii)
- **Podpora viacerých jazykov**: Automatizované preklady do viac než 50 jazykov cez GitHub Actions
- **Technológie**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (pre AI projekty)
- **Vzdelávací obsah**: 24 štruktúrovaných lekcií organizovaných do modulov založených na projektoch
- **Praktické projekty**: Terrarium, Hra na písanie, Rozšírenie prehliadača, Hra vo vesmíre, Banková aplikácia, Kódový editor a AI chat asistent
- **Interaktívne kvízy**: 48 kvízov s 3 otázkami v každom (pred a po lekcii)
- **Podpora viacerých jazykov**: Automatické preklady do 50+ jazykov cez GitHub Actions
- **Technológie**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (pre AI projekty)
### Architektúra
- Vzdelávací repozitár so štruktúrou založenou na lekciách
- Každý adresár lekcie obsahuje README, príklady kódu a riešenia
- Samostatné projekty v oddelených adresároch (quiz-app, rôzne projekty lekcií)
- Prekladový systém využívajúci GitHub Actions (co-op-translator)
- Dokumentácia podávaná cez Docsify a dostupná ako PDF
- Vzdelávací repozitár so štruktúrou založenou na lekciách
- Každá zložka lekcie obsahuje README, príklady kódu a riešenia
- Samostatné projekty v oddelených adresároch (quiz-app, rôzne lekčné projekty)
- Prekladový systém používajúci GitHub Actions (co-op-translator)
- Dokumentácia podávaná pomocou Docsify a dostupná ako PDF
## Príkazy na nastavenie
Tento repozitár je primárne určený na konzumovanie vzdelávacieho obsahu. Pre prácu s konkrétnymi projektmi:
Tento repozitár je primárne určený na konzumáciu vzdelávacieho obsahu. Pre prácu s konkrétnymi projektmi:
### Nastavenie hlavného repozitára
@ -30,18 +30,18 @@ Tento repozitár je primárne určený na konzumovanie vzdelávacieho obsahu. Pr
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### Nastavenie Quiz Aplikácie (Vue 3 + Vite)
### Nastavenie Quiz App (Vue 3 + Vite)
```bash
cd quiz-app
npm install
npm run dev # Spustiť vývojový server
npm run build # Vytvoriť verziu pre produkciu
npm run build # Vytvoriť build pre produkciu
npm run lint # Spustiť ESLint
```
### Bankový projekt API (Node.js + Express)
### Bankový projekt API (Node.js + Express)
```bash
cd 7-bank-project/api
@ -50,70 +50,70 @@ npm start # Spustiť API server
npm run lint # Spustiť ESLint
npm run format # Naformátovať pomocou Prettier
```
### Projekty Rozšírení prehliadača
### Projekty pre rozšírenie prehliadača
```bash
cd 5-browser-extension/solution
npm install
# Postupujte podľa pokynov na načítanie rozšírení špecifických pre prehliadač
```
### Projekty Hry v priestore
### Projekty vesmírnej hry
```bash
cd 6-space-game/solution
npm install
# Otvorte index.html v prehliadači alebo použite Live Server
```
### Chat Projekt (Python Backend)
### Chat projekt (Python Backend)
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# Nastavte premennú prostredia GITHUB_TOKEN
# Nastavte environmentálnu premennú GITHUB_TOKEN
python api.py
```
## Vývojový pracovný tok
## Vývojový pracovný postup
### Pre prispievateľov obsahu
1. **Vytvorte fork** repozitára do svojho GitHub účtu
2. **Klonujte svoj fork** lokálne
3. **Vytvorte novú vetvu** pre svoje zmeny
4. Upravte obsah lekcií alebo príklady kódu
5. Otestujte zmeny kódu v príslušných adresároch projektov
6. Odoslať pull requesty podľa pravidiel prispievania
1. **Vytvorte fork repozitára** do vášho GitHub účtu
2. **Naklonujte svoj fork** lokálne
3. **Vytvorte novú vetvu** pre vaše zmeny
4. Upravujte obsah lekcií alebo príklady kódu
5. Testujte akékoľvek zmeny kódu v príslušných adresároch projektov
6. Podávajte pull requesty podľa pokynov na prispievanie
### Pre študentov
1. Vytvorte fork alebo klon repozitára
2. Prechádzajte adresáre lekcií postupne
3. Čítajte README súbory ku každej lekcii
4. Dokončite predlekčné kvízy na https://ff-quizzes.netlify.app/web/
5. Pracujte s príkladmi kódu v adresároch lekcií
6. Splňte úlohy a výzvy
7. Vykonajte po lekčné kvízy
1. Forknite alebo sklonujte repozitár
2. Sekvenčne prechádzajte adresármi lekcií
3. Čítajte README súbory ku každej lekcii
4. Vyplňte predlekčné kvízy na https://ff-quizzes.netlify.app/web/
5. Prechádzajte cez príklady kódu v adresároch lekcií
6. Dokončite úlohy a výzvy
7. Vyplňte popočaskové kvízy
### Priame vývojové prostredie
### Živý vývoj
- **Dokumentácia**: Spustite `docsify serve` v koreňovom adresári (port 3000)
- **Quiz App**: Spustite `npm run dev` v adresári quiz-app
- **Projekty**: Použite VS Code Live Server rozšírenie pre HTML projekty
- **API Projekty**: Spustite `npm start` v príslušných API adresároch
- **Dokumentácia**: Spustite `docsify serve` v koreňovom adresári (port 3000)
- **Quiz App**: Spustite `npm run dev` v adresári quiz-app
- **Projekty**: Použite VS Code Live Server rozšírenie pre HTML projekty
- **API projekty**: Spustite `npm start` v príslušných API adresároch
## Inštrukcie na testovanie
### Testovanie Quiz Aplikácie
### Testovanie Quiz App
```bash
cd quiz-app
npm run lint # Skontrolujte problémy so štýlom kódu
npm run build # Overte, či je zostavenie úspešné
npm run build # Overte, či zostavenie prebehne úspešne
```
### Testovanie Bank API
```bash
@ -121,77 +121,77 @@ cd 7-bank-project/api
npm run lint # Skontrolujte problémy so štýlom kódu
node server.js # Overte, či server štartuje bez chýb
```
### Všeobecný prístup k testovaniu
- Toto je vzdelávací repozitár bez komplexných automatizovaných testov
- Manuálne testovanie sa zameriava na:
- Spustenie príkladov kódu bez chýb
- Funkčnosť odkazov v dokumentácii
- Úspešné zostavenie projektov
- Dodržiavanie najlepších postupov v príkladoch
- Toto je vzdelávací repozitár bez komplexných automatizovaných testov
- Manuálne testovanie sa zameriava na:
- Spustenie príkladov kódu bez chýb
- Správne fungovanie odkazov v dokumentácii
- Úspešné zostavenie projektov
- Príklady dodržiavajú najlepšie postupy
### Kontroly pred odoslaním
- Spustite `npm run lint` v adresároch obsahujúcich package.json
- Overte platnosť odkazov v markdown súboroch
- Otestujte príklady kódu v prehliadači alebo Node.js
- Skontrolujte, že preklady zachovávajú správnu štruktúru
- Spustite `npm run lint` v adresároch s package.json
- Overte, či sú markdown odkazy platné
- Testujte príklady kódu v prehliadači alebo Node.js
- Skontrolujte, či preklady zachovávajú správnu štruktúru
## Pravidlá štýlu kódu
## Pokyny pre štýl kódu
### JavaScript
- Používajte modernú syntax ES6+
- Dodržiavajte štandardné ESLint konfigurácie v projektoch
- Používajte zrozumiteľné mená premenných a funkcií pre lepšiu výučbu
- Pridávajte komentáre vysvetľujúce koncepty pre študentov
- Formátovanie pomocou Prettier tam, kde je nastavené
- Používajte modernú ES6+ syntax
- Dodržiavajte štandardné ESLint konfigurácie poskytnuté v projektoch
- Používajte zmysluplné názvy premenných a funkcií pre lepšie vzdelávanie
- Pridávajte komentáre vysvetľujúce koncepty pre študentov
- Formátujte pomocou Prettier tam, kde je nastavený
### HTML/CSS
- Semantické HTML5 prvky
- Princípy responzívneho dizajnu
- Jasné pomenovanie CSS tried
- Komentáre vysvetľujúce CSS techniky pre študentov
- Sémantické HTML5 elementy
- Zásady responzívneho dizajnu
- Jasné pomenovanie tried
- Komentáre vysvetľujúce CSS techniky pre študentov
### Python
- Dodržiavajte PEP 8 štýlové smernice
- Čisté, vzdelávacie príklady kódu
- Typové anotácie tam, kde pomáhajú pri učení
- Dodržiavajte štýlové smernice PEP 8
- Jasné, vzdelávacie príklady kódu
- Používajte typové hinty tam, kde sú užitočné pre učenie
### Markdown Dokumentácia
### Markdown dokumentácia
- Jasná hierarchia nadpisov
- Bloky kódu s definovaním jazyka
- Odkazy na doplnkové zdroje
- Screenshoty a obrázky v adresároch `images/`
- Alternatívny text pre obrázky pre prístupnosť
- Jasná hierarchia nadpisov
- Kódové bloky s určením jazyka
- Odkazy na ďalšie zdroje
- Snímky obrazovky a obrázky v adresároch `images/`
- Alternatívny text pre obrázky pre prístupnosť
### Organizácia súborov
- Lekcie sú očíslované postupne (1-getting-started-lessons, 2-js-basics atď.)
- Každý projekt má adresáre `solution/` a často `start/` alebo `your-work/`
- Obrázky sú uložené v špecifických adresároch lekcií `images/`
- Preklady v adresárovej štruktúre `translations/{language-code}/`
- Lekcie číslované po poradí (1-getting-started-lessons, 2-js-basics, atď.)
- Každý projekt má `solution/` a často `start/` alebo `your-work/` adresáre
- Obrázky uložené v lekciami špecifických `images/` priečinkoch
- Preklady v štruktúre `translations/{language-code}/`
## Build a Nasadenie
## Sestavenie a nasadenie
### Nasadenie Quiz Aplikácie (Azure Static Web Apps)
### Nasadenie Quiz App (Azure Static Web Apps)
Quiz-app je nakonfigurovaný pre nasadenie ako Azure Static Web Apps:
Quiz-app je nakonfigurovaný pre nasadenie na Azure Static Web Apps:
```bash
cd quiz-app
npm run build # Vytvára priečinok dist/
# Nasadzuje cez workflow GitHub Actions pri push do main
# Nasadzuje cez workflow GitHub Actions pri pushnutí do main
```
Konfigurácia Azure Static Web Apps:
- **Umiestnenie aplikácie**: `/quiz-app`
- **Výstupné umiestnenie**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
Konfigurácia Azure Static Web Apps:
- **Umiestnenie aplikácie**: `/quiz-app`
- **Výstupné umiestnenie**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Generovanie PDF dokumentácie
@ -199,84 +199,84 @@ Konfigurácia Azure Static Web Apps:
npm install # Nainštalujte docsify-to-pdf
npm run convert # Vygenerujte PDF z docs
```
### Dokumentácia Docsify
```bash
npm install -g docsify-cli # Nainštalovať Docsify globálne
docsify serve # Spustiť na localhost:3000
npm install -g docsify-cli # Nainštalujte Docsify globálne
docsify serve # Spustite na localhost:3000
```
### Projektovo špecifické buildy
Každý projektový adresár môže mať svoj vlastný build proces:
- Vue projekty: `npm run build` vytvára produkčné balíky
- Statické projekty: žiadny build krok, súbory sa servujú priamo
### Špecifické zostavenia projektov
Každý projektový adresár môže mať vlastný build proces:
- Vue projekty: `npm run build` vytvára produkčné balíky
- Statické projekty: Žiadny build krok, súbory sa servujú priamo
## Pravidlá pre pull requesty
## Pokyny pre pull requesty
### Formát názvu
Používajte jasné, zrozumiteľné názvy indikujúce oblasť zmeny:
- `[Quiz-app] Pridanie nového kvízu pre lekciu X`
- `[Lesson-3] Oprava preklepu v projekte terrarium`
- `[Translation] Pridanie španielskeho prekladu pre lekciu 5`
- `[Docs] Aktualizácia inštrukcií pre nastavenie`
Používajte jasné, popisné názvy indikujúce oblasť zmeny:
- `[Quiz-app] Pridanie nového kvízu pre lekciu X`
- `[Lesson-3] Oprava preklepu v projekte terrárium`
- `[Translation] Pridanie španielskeho prekladu pre lekciu 5`
- `[Docs] Aktualizácia inštrukcií na nastavenie`
### Povinné kontroly
Pred odoslaním PR:
Pred odoslaním PR:
1. **Kvalita kódu**:
- Spustite `npm run lint` v ovplyvnených projektových adresároch
- Opravte všetky chyby a varovania z lintovania
1. **Kvalita kódu**:
- Spustite `npm run lint` v dotknutých projektových adresároch
- Opravte všetky chyby a varovania lintu
2. **Overenie buildovania**:
- Spustite `npm run build` pokiaľ je to relevantné
- Uistite sa, že nie sú žiadne chyby pri buildovaní
2. **Overenie zostavenia**:
- Spustite `npm run build`, ak je to potrebné
- Uistite sa, že nevznikli žiadne chyby zostavenia
3. **Validácia odkazov**:
- Otestujte všetky markdown odkazy
- Overte, že odkazy na obrázky fungujú
3. **Overenie odkazov**:
- Otestujte všetky markdown odkazy
- Overte, či obrázkové odkazy fungujú
4. **Kontrola obsahu**:
- Korektúra pravopisu a gramatiky
- Uistite sa, že príklady kódu sú správne a vzdelávacie
- Skontrolujte, že preklady zachovávajú pôvodný význam
4. **Kontrola obsahu**:
- Skontrolujte pravopis a gramatiku
- Uistite sa, že príklady kódu sú správne a vzdelávacie
- Overte, či preklady zachovávajú pôvodný význam
### Požiadavky na príspevky
### Požiadavky na prispievanie
- Súhlas s Microsoft CLA (automatická kontrola pri prvom PR)
- Dodržiavanie [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Pozrite [CONTRIBUTING.md](./CONTRIBUTING.md) pre podrobné pokyny
- V PR popise uveďte čísla súvisiacich issues, ak sú relevantné
- Súhlas s Microsoft CLA (automatická kontrola pri prvom PR)
- Dodržiavanie [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Pozrite [CONTRIBUTING.md](./CONTRIBUTING.md) pre podrobné pokyny
- V prípade potreby uvádzajte čísla issue v popise PR
### Proces preskúmania
### Proces revízie
- PR sú kontrolované správcom a komunitou
- Prioritou je vzdelávacia zrozumiteľnosť
- Príklady kódu by mali byť podľa súčasných najlepších praktík
- Preklady sa kontrolujú z hľadiska presnosti a kultúrnej vhodnosti
- PR prezerajú správci a komunita
- Preferuje sa jasnosť pre vzdelávanie
- Príklady kódu by mali nasledovať aktuálne najlepšie postupy
- Preklady sú kontrolované na presnosť a kultúrnu vhodnosť
## Prekladový systém
### Automatizovaný preklad
### Automatický preklad
- Využíva GitHub Actions s workflow co-op-translator
- Automaticky prekladá do viac než 50 jazykov
- Zdrojové súbory sú v hlavných adresároch
- Preložené súbory v adresároch `translations/{language-code}/`
- Používa GitHub Actions s workflow co-op-translator
- Automaticky prekladá do 50+ jazykov
- Zdrojové súbory v hlavných adresároch
- Preložené súbory v `translations/{language-code}/` adresároch
### Pridávanie manuálnych vylepšení prekladu
### Pridávanie manuálnych zlepšení prekladu
1. Nájdite súbor v `translations/{language-code}/`
2. Zlepšite obsah pri zachovaní štruktúry
3. Zabezpečte, aby príklady kódu ostali funkčné
4. Otestujte lokalizovaný obsah kvízov
1. Nájdite súbor v `translations/{language-code}/`
2. Vykonajte úpravy pri zachovaní štruktúry
3. Uistite sa, že príklady kódu zostávajú funkčné
4. Otestujte lokalizovaný obsah kvízu
### Metaúdaje prekladu
### Metaúdaje o preklade
Preložené súbory obsahujú hlavičku s metaúdajmi:
Preložené súbory obsahujú hlavičku s metaúdajmi:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -288,121 +288,121 @@ CO_OP_TRANSLATOR_METADATA:
}
-->
```
## Ladenie a riešenie problémov
### Bežné problémy
**Quiz aplikácia sa nespustí**:
- Skontrolujte verziu Node.js (odporúčaná v14+)
- Vymažte `node_modules` a `package-lock.json`, potom spustite `npm install` znova
- Skontrolujte konflikty portov (prednastavený port Vite je 5173)
**Quiz app sa nespustí**:
- Skontrolujte verziu Node.js (odporúčané v14+)
- Vymažte `node_modules` a `package-lock.json`, spustite `npm install` znova
- Skontrolujte konflikty portov (predvolene: Vite používa port 5173)
**API server sa nespustí**:
- Overte minimálnu požadovanú verziu Node.js (node >=10)
- Skontrolujte, či nie je port obsadený
- Uistite sa, že všetky závislosti sú nainštalované cez `npm install`
**API server sa nespustí**:
- Overte, či verzia Node.js spĺňa minimum (node >=10)
- Skontrolujte, či port už nie je obsadený
- Uistite sa, že sú všetky závislosti nainštalované pomocou `npm install`
**Rozšírenie prehliadača sa nenahodí**:
- Skontrolujte správnosť formátu súboru manifest.json
- Pozrite konzolu prehliadača na chyby
- Postupujte podľa špecifických inštrukcií prehliadača na inštaláciu rozšírení
**Rozšírenie prehliadača sa nenačíta**:
- Skontrolujte, či je manifest.json správne naformátovaný
- Pozrite do konzoly prehliadača pre chyby
- Postupujte podľa špecifických inštrukcií na inštaláciu rozšírení pre daný prehliadač
**Problémy s chat projektom v Pythone**:
- Uistite sa, že balík OpenAI je nainštalovaný: `pip install openai`
- Overte nastavenie environmentálnej premennej GITHUB_TOKEN
- Skontrolujte prístupové práva pre GitHub Models
**Problémy s Python chat projektom**:
- Uistite sa, že je nainštalovaný balík OpenAI: `pip install openai`
- Overte, či je nastavená environmentálna premenná GITHUB_TOKEN
- Skontrolujte prístupové povolenia pre GitHub Models
**Docsify neservuje dokumentáciu**:
- Globálne nainštalujte docsify-cli: `npm install -g docsify-cli`
- Spustite z koreňového adresára repozitára
- Skontrolujte, či existuje `docs/_sidebar.md`
**Docsify nedodáva dokumenty**:
- Globálne nainštalujte docsify-cli: `npm install -g docsify-cli`
- Spúšťajte z koreňového adresára repozitára
- Overte, či existuje `docs/_sidebar.md`
### Tipy pre vývojové prostredie
- Používajte VS Code s rozšírením Live Server pre HTML projekty
- Nainštalujte si ESLint a Prettier rozšírenia pre konzistentné formátovanie
- Používajte DevTools v prehliadači pre ladenie JavaScriptu
- Pre Vue projekty nainštalujte Vue DevTools rozšírenie prehliadača
- Používajte VS Code s rozšírením Live Server pre HTML projekty
- Nainštalujte rozšírenia ESLint a Prettier pre jednotné formátovanie
- Používajte DevTools prehliadača na ladenie JavaScriptu
- Pre Vue projekty nainštalujte Vue DevTools rozšírenie prehliadača
### Výkonnostné úvahy
### Výkonnostné odporúčania
- Veľké množstvo preložených súborov (50+ jazykov) znamená veľké klony
- Používajte shallow clone pre prácu iba s obsahom: `git clone --depth 1`
- Vynechajte preklady z vyhľadávania, keď pracujete v angličtine
- Build procesy môžu byť pri prvom spustení pomalé (npm install, Vite build)
- Veľký počet preložených súborov (50+ jazykov) spôsobuje, že klony sú veľké
- Používajte shallow clone, ak pracujete iba s obsahom: `git clone --depth 1`
- Pri práci s anglickým obsahom vylúčte preklady zo vyhľadávania
- Build procesy môžu byť pri prvom spustení pomalé (npm install, Vite build)
## Bezpečnostné upozornenia
## Bezpečnostné opatrenia
### Environmentálne premenné
- API kľúče by nikdy nemali byť commitnuté do repozitára
- Používajte `.env` súbory (už sú v `.gitignore`)
- Dokumentujte požadované environmentálne premenné v README projektoch
- API kľúče by nikdy nemali byť commitované do repozitára
- Používajte `.env` súbory (už v `.gitignore`)
- Požadované environmentálne premenne dokumentujte v README projektov
### Python Projekty
### Python projekty
- Používajte virtuálne prostredia: `python -m venv venv`
- Udržiavajte závislosti aktuálne
- GitHub tokeny by mali mať minimálne potrebné oprávnenia
- Používajte virtuálne prostredia: `python -m venv venv`
- Udržiavajte závislosti aktuálne
- GitHub tokeny by mali mať minimálne potrebné povolenia
### Prístup k GitHub Models
- Osobné prístupové tokeny (PAT) sú vyžadované pre GitHub Models
- Tokeny by mali byť uložené ako environmentálne premenné
- Nikdy necommitujte tokeny alebo prístupové údaje
- Pre GitHub Models sú potrebné osobné prístupové tokeny (PAT)
- Tokeny ukladajte ako environmentálne premenné
- Nikdy necommitujte tokeny alebo prihlasovacie údaje
## Dodatočné poznámky
## Ďalšie poznámky
### Cieľová skupina
- Úplní začiatočníci v oblasti webového vývoja
- Študenti a samoukovia
- Učitelia využívajúci tento kurz v triedach
- Obsah navrhnutý pre prístupnosť a postupné zvyšovanie zručností
- Úplní začiatočníci vo webovom vývoji
- Študenti a samoukovia
- Učitelia používajúci kurikulum v triedach
- Obsah navrhnutý pre prístupnosť a postupné zlepšovanie zručností
### Vzdelávacia filozofia
- Projektovo orientovaný prístup k učeniu
- Časté overovanie poznatkov (kvízy)
- Praktické cvičenia s kódom
- Príklady použitia v reálnych situáciách
- Zameranie na základy pred frameworkmi
- Prístup založený na projektovom učení
- Časté overovanie vedomostí (kvízy)
- Praktické cvičenia s kódovaním
- Príklady reálnych aplikácií
- Zameranie na základy pred frameworkmi
### Údržba repozitára
- Aktívna komunita študentov a prispievateľov
- Pravidelné aktualizácie závislostí a obsahu
- Issues a diskusie spravované udržiavateľmi
- Preklady aktualizované automaticky cez GitHub Actions
- Aktívna komunita študentov a prispievateľov
- Pravidelné aktualizácie závislostí a obsahu
- Problémy a diskusie monitorované správcami
- Aktualizácie prekladov automatizované cez GitHub Actions
### Súvisiace zdroje
- [Microsoft Learn moduly](https://docs.microsoft.com/learn/)
- [Zdroje pre študentov](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) odporúčaný pre študentov
- Ďalšie kurzy: Generatívna AI, Data Science, ML, IoT dostupné
- [Microsoft Learn moduly](https://docs.microsoft.com/learn/)
- [Student Hub zdroje](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) odporúčaný pre študentov
- Ďalšie kurzy: Generatívna AI, Data Science, ML, IoT kurikulum dostupné
### Práca s konkrétnymi projektmi
Pre podrobné návody ku jednotlivým projektom si prečítajte README súbory v:
- `quiz-app/README.md` - Vue 3 kvízová aplikácia
- `7-bank-project/README.md` - Banková aplikácia s autentifikáciou
- `5-browser-extension/README.md` - Vývoj rozšírenia prehliadača
- `6-space-game/README.md` - Vývoj hry pomocou Canvasu
- `9-chat-project/README.md` - Projekt AI chat asistenta
Pre podrobné inštrukcie k jednotlivým projektom nájdete README súbory v:
- `quiz-app/README.md` - Vue 3 quiz aplikácia
- `7-bank-project/README.md` - Banková aplikácia s autentifikáciou
- `5-browser-extension/README.md` - Vývoj rozšírenia prehliadača
- `6-space-game/README.md` - Vývoj hry založenej na Canvas
- `9-chat-project/README.md` - Projekt AI chat asistenta
### Štruktúra monorepa
### Štruktúra monorepo
Hoci to nie je tradičné monorepo, repozitár obsahuje viacero nezávislých projektov:
- Každá lekcia je samostatná
- Projekty nezdieľajú závislosti
- Pracujte na jednotlivých projektoch bez ovplyvnenia ostatných
- Klonujte celý repozitár pre kompletný kurzový zážitok
Hoci nejde o tradičné monorepo, tento repozitár obsahuje viacero nezávislých projektov:
- Každá lekcia je samostatná
- Projekty si nesdielajú závislosti
- Pracujte na jednotlivých projektoch bez ovplyvnenia iných
- Naklonujte celý repozitár pre kompletný zážitok z kurikula
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Vyhlásenie o zodpovednosti**:
Tento dokument bol preložený pomocou AI prekladateľskej služby [Co-op Translator](https://github.com/Azure/co-op-translator). Hoci sa snažíme o presnosť, majte prosím na pamäti, že automatizované preklady môžu obsahovať chyby alebo nepresnosti. Originálny dokument v jeho pôvodnom jazyku by mal byť považovaný za autoritatívny zdroj. Pre kritické informácie sa odporúča profesionálny ľudský preklad. Nie sme zodpovední za akékoľvek nedorozumenia alebo nesprávne výklady vyplývajúce z použitia tohto prekladu.
**Upozornenie**:
Tento dokument bol preložený pomocou AI prekladateľskej služby [Co-op Translator](https://github.com/Azure/co-op-translator). Aj keď sa snažíme o presnosť, berte prosím na vedomie, že automatické preklady môžu obsahovať chyby alebo nepresnosti. Pôvodný dokument v jeho pôvodnom jazyku by mal byť považovaný za autoritatívny zdroj. Pre dôležité informácie sa odporúča profesionálny ľudský preklad. Nie sme zodpovední za žiadne nedorozumenia alebo nesprávne interpretácie vyplývajúce z použitia tohto prekladu.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->
Write Preview
Loading…
Cancel
Save