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 386ac6105f
commit 80abf535cf
6 changed files with 519 additions and 519 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-06T09:49:52+00:00",
"translation_date": "2026-02-06T11:52:46+00:00",
"source_file": "AGENTS.md",
"language_code": "cs"
},

252
translations/cs/AGENTS.md
Unescape View File

@ -7,24 +7,24 @@ Toto je vzdělávací repozitář kurikula pro výuku základů webového vývoj
### Klíčové součásti
- **Vzdělávací obsah**: 24 strukturovaných lekcí uspořádaných do modulů založených na projektech
- **Praktické projekty**: Terrárium, Hra na psaní, Rozšíření prohlížeče, Hra ve vesmíru, Bankovní aplikace, Editor kódu a AI chatovací asistent
- **Interaktivní kvízy**: 48 kvízů, každý s 3 otázkami (před a po lekci)
- **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)
### Architektura
- Vzdělávací repozitář s lekcemi strukturovanými podle lekcí
- Každá složka lekce obsahuje README, příklady kódu a řešení
- Samostatné projekty v oddělených adresářích (quiz-app, různé lekční projekty)
- 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 podávána přes Docsify a dostupná jako PDF
- Dokumentace servírovaná pomocí Docsify a dostupná také jako PDF
## Příkazy pro nastavení
Tento repozitář je primárně určen k výuce. Pro práci s konkrétními projekty:
Tento repozitář je primárně určen ke konzumaci vzdělávacího obsahu. Pro práci se specifickými projekty:
### Hlavní nastavení repozitáře
### Nastavení hlavního repozitáře
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
@ -37,7 +37,7 @@ cd Web-Dev-For-Beginners
cd quiz-app
npm install
npm run dev # Spustit vývojový server
npm run build # Vytvořit build pro produkci
npm run build # Sestavit pro produkci
npm run lint # Spustit ESLint
```
@ -56,10 +56,10 @@ npm run format # Formátovat pomocí Prettier
```bash
cd 5-browser-extension/solution
npm install
# Postupujte podle pokynů specifických pro načítání rozšíření v prohlížeči
# Postupujte podle pokynů pro načítání rozšíření specifických pro prohlížeč
```
### Projekty Hry ve vesmíru
### Projekty Space Game
```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
```
### Chatovací projekt (Python backend)
### Chat projekt (Python Backend)
```bash
cd 9-chat-project/solution/backend/python
@ -76,35 +76,35 @@ pip install openai
python api.py
```
## Vývojový pracovní postup
## Vývojový workflow
### Pro přispěvatele obsahu
1. **Vytvořte fork repozitáře** na svůj GitHub účet
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 obsahu lekcí nebo příkladů kódu
5. Testujte jakékoli změny kódu v příslušných projektových složkách
6. Odesílejte pull requesty podle pravidel přispívání
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í
### Pro studenty
1. Forkujte nebo naklonujte repozitář
2. Procházejte složky lekcí postupně
3. Čtěte README soubory ke každé lekci
4. Dokončete předlekční kvízy na https://ff-quizzes.netlify.app/web/
5. Procházejte příklady kódu ve složkách lekcí
6. Plňte úkoly a výzvy
7. Udělejte si post-lekční kvízy
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
### Živý 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žijte VS Code Live Server rozšíření pro HTML projekty
- **API projekty**: Spusťte `npm start` v příslušných API složkách
- **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
## Instrukce pro testování
## Testovací instrukce
### Testování Quiz App
@ -114,69 +114,69 @@ npm run lint # Zkontrolujte problémy se stylem kódu
npm run build # Ověřte, že sestavení proběhlo úspěšně
```
### Testování bankovního API
### Testování Bank API
```bash
cd 7-bank-project/api
npm run lint # Zkontrolujte problémy s kódovým stylem
npm run lint # Zkontrolujte problémy se stylem kódu
node server.js # Ověřte, že server startuje bez chyb
```
### Obecný přístup k testování
- Jedná se o vzdělávací repozitář bez komplexních automatizovaných testů
- Jedná se o edukativní repozitář bez komplexních automatizovaných testů
- Manuální testování se zaměřuje na:
- Spuštění příkladů kódu bez chyb
- Funkčnost odkazů v dokumentaci
- Úspěšné sestavení projektů
- 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
### Kontroly před odesláním
- Spusťte `npm run lint` ve složkách s package.json
- Ověřte platnost markdown odkazů
- Testujte příklady kódu v prohlížeči nebo Node.js
- 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
## Směrnice stylu kódu
## Pravidla pro styl kódu
### JavaScript
- Používejte moderní syntaxi ES6+
- Dodržujte standardní ESLint konfigurace v projektech
- Používejte smysluplné názvy proměnných a funkcí pro vzdělávací přehlednost
- Přidávejte komentáře vysvětlující koncepty pro studenty
- Formátujte pomocí Prettier, kde je nakonfigurováno
- 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
### HTML/CSS
- Sémantické HTML5 prvky
- Principy responzivního designu
- Jasné pojmenování tříd
- 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
### Python
- Dodržujte směrnice stylu PEP 8
- Jasné, vzdělávací příklady kódu
- Používejte typové nápovědy tam, kde jsou pro výuku užitečné
- 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í
### Dokumentace v Markdown
### Markdown dokumentace
- Jasná hierarchie nadpisů
- Bloky kódu s určením jazyka
- Odkazy na další zdroje
- Snímky a obrázky ve složkách `images/`
- Alt texty pro obrázky pro přístupnost
- 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
### Organizace souborů
- Lekce číslovány sekvenčně (1-getting-started-lessons, 2-js-basics atd.)
- 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žené do lekčních složek `images/`
- Překlady v adresáři `translations/{language-code}/`
- Obrázky uloženy v lekcích specifických složkách `images/`
- Překlady ve složkách `translations/{language-code}/`
## Sestavení a nasazení
## Build a deploy
### Nasazení Quiz App (Azure Static Web Apps)
@ -185,7 +185,7 @@ Quiz-app je nakonfigurován pro nasazení na Azure Static Web Apps:
```bash
cd quiz-app
npm run build # Vytváří složku dist/
# Nasazuje pomocí workflow GitHub Actions při pushnutí do větve main
# Nasazuje prostřednictvím workflow GitHub Actions při pushi do větve main
```
Konfigurace Azure Static Web Apps:
@ -197,29 +197,29 @@ Konfigurace Azure Static Web Apps:
```bash
npm install # Nainstalujte docsify-to-pdf
npm run convert # Vytvořte PDF z dokumentace
npm run convert # Vygenerujte PDF z docs
```
### Dokumentace Docsify
```bash
npm install -g docsify-cli # Nainstalujte Docsify globálně
docsify serve # Spusťte na localhost:3000
docsify serve # Podávejte na localhost:3000
```
### Sestavení specifické pro projekt
### Specifické buildy projektů
Každý projekt může mít svůj vlastní build proces:
Každý projekt může mít vlastní build proces:
- Vue projekty: `npm run build` vytváří produkční balíčky
- Statické projekty: žádný build krok, soubory se podávají přímo
- Statické projekty: Bez build kroku, servírují přímo soubory
## Pravidla pro pull requesty
### Formát názvu
Používejte jasné, výstižné názvy udávající oblast změny:
Používejte jasné, popisné názvy indikující oblast změny:
- `[Quiz-app] Přidat nový kvíz pro lekci X`
- `[Lesson-3] Opravit překlep v projektu terrárium`
- `[Lesson-3] Oprava překlepu v projektu terrarium`
- `[Translation] Přidat španělský překlad pro lekci 5`
- `[Docs] Aktualizovat instrukce pro nastavení`
@ -228,55 +228,55 @@ Používejte jasné, výstižné názvy udávající oblast změny:
Před odesláním PR:
1. **Kvalita kódu**:
- Spusťte `npm run lint` ve zasažených projektových složkách
- Opravte všechny chyby a varování lintu
- Spusťte `npm run lint` v dotčených projektových složkách
- Opravte všechny linting chyby a varování
2. **Ověření sestavení**:
- Pokud je to možné, spusťte `npm run build`
- Ujistěte se, že nejsou chyby build procesu
2. **Ověření buildu**:
- Spusťte `npm run build` je-li to relevantní
- Zajistěte žádné build chyby
3. **Ověření odkazů**:
- Otestujte všechny markdown odkazy
- Testujte všechny markdown odkazy
- Ověřte, že odkazy na obrázky fungují
4. **Kontrola obsahu**:
- Korektura pravopisu a gramatiky
- Ověření správnosti a vzdělávací hodnoty příkladů kódu
- Kontrola, že překlady zachovávají původní význam
- Přesnost a vzdělávací hodnota příkladů kódu
- Přesnost a zachování smyslu překladu
### Požadavky na příspěvek
### Požadavky na přispívá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
- Veškeré PR by měly odkazovat na čísla issues, pokud je to relevantní
- Uvádění čísel issues v popisu PR, pokud relevantní
### Přezkum PR
### Proces revize
- PR jsou přezkoumávány správci i komunitou
- Preferována je vzdělávací srozumitelnost
- Příklady kódu by měly odpovídat současným nejlepším praktikám
- Překlady jsou kontrolovány z hlediska přesnosti a kulturní vhodnosti
- 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
## Překladový systém
### Automatický překlad
- Používá GitHub Actions s workflow co-op-translator
- Automaticky překládá do více než 50 jazyků
- Zdrojové soubory jsou v hlavních adresářích
- Přeložené soubory jsou v `translations/{language-code}/`
- Překlad do více než 50 jazyků automaticky
- Zdrojové soubory v hlavních adresářích
- Přeložené soubory v `translations/{language-code}/`
### Přidávání manuálních překladatelských vylepšení
### Přidávání ručních překladových vylepšení
1. Najděte soubor v `translations/{language-code}/`
2. Proveďte vylepšení, přičemž zachovejte strukturu
3. Ujistěte se, že příklady kódu zůstávají funkční
4. Otestujte lokalizovaný obsah kvízu
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
### Metadata překladu
Přeložené soubory obsahují hlavičku s metadaty:
Přeložené soubory obsahují hlavičku s metadata:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -289,55 +289,55 @@ CO_OP_TRANSLATOR_METADATA:
-->
```
## Ladění a odstraňování problémů
## Ladění a řešení problémů
### Běžné problémy
**Quiz app se nespustí**:
**Quiz app nelze spustit**:
- Zkontrolujte verzi Node.js (doporučeno v14+)
- Smažte `node_modules` a `package-lock.json`, spusťte znovu `npm install`
- Zkontrolujte konflikt portů (výchozí: Vite používá port 5173)
- Smažte `node_modules` a `package-lock.json`, spusťte `npm install` znovu
- Zkontrolujte konflikty portů (standardně Vite používá port 5173)
**API server se nespustí**:
- Ověřte minimální verzi Node.js (node >=10)
- Ověřte, že verze Node.js splňuje minimum (node >=10)
- Zkontrolujte, zda port není již obsazený
- Ujistěte se, že všechny závislosti jsou nainstalovány pomocí `npm install`
- Zajistěte, že všechny závislosti jsou nainstalovány (`npm install`)
**Rozšíření prohlížeče se nenačte**:
- Ověřte správné formátování manifest.json
- Prohlédněte si konzoli prohlížeče pro chyby
- Postupujte podle specifických instrukcí pro instalaci rozšíření v prohlížeči
- Podívejte se do konzole prohlížeče na chyby
- Dodržujte instrukce pro instalaci podle prohlížeče
**Problémy s Python chat projektem**:
- Zajistěte instalaci balíčku OpenAI: `pip install openai`
- Ověřte nastavení proměnné prostředí GITHUB_TOKEN
- Zkontrolujte oprávnění pro přístup k GitHub Models
- 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
**Docsify negeneruje dokumentaci**:
- Globálně nainstalujte docsify-cli: `npm install -g docsify-cli`
**Docsify neslouží dokumentaci**:
- Nainstalujte docsify-cli globálně: `npm install -g docsify-cli`
- Spusťte z kořenového adresáře repozitáře
- Ujistěte se, že existuje soubor `docs/_sidebar.md`
- Zkontrolujte, že `docs/_sidebar.md` existuje
### 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 browser DevTools pro ladění JavaScriptu
- Pro projekty Vue nainstalujte Vue DevTools rozšíření do prohlížeče
- Používejte DevTools v prohlížeči pro ladění JavaScriptu
- Pro Vue projekty nainstalujte Vue DevTools rozšíření prohlížeče
### Výkonové úvahy
### Výkonové aspekty
- Velký počet překladů (50+ jazyků) znamená velké kompletní klony
- Použijte shallow clone, pokud pracujete jen s obsahem: `git clone --depth 1`
- Vylučujte překlady ze vyhledávání při práci na anglickém obsahu
- Build procesy mohou být při prvním spuštění pomalé (npm install, Vite build)
- 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)
## Bezpečnostní opatření
## 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 (již uvedeny v `.gitignore`)
- Používejte `.env` soubory (jsou již zahrnuty v `.gitignore`)
- Dokumentujte požadované proměnné prostředí v README projektech
### Python projekty
@ -348,33 +348,33 @@ CO_OP_TRANSLATOR_METADATA:
### Přístup k GitHub Models
- Pro GitHub Models jsou potřeba osobní přístupové tokeny (PAT)
- Tokeny by měly být uloženy v proměnných prostředí
- Nikdy neukládejte tokeny nebo přihlašovací údaje do repozitáře
- 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
## Další poznámky
### Cílová skupina
- Naprostí začátečníci ve webovém vývoji
- Kompletní začátečníci ve webovém vývoji
- Studenti a samouci
- Učitelé používající kurikulum ve třídách
- Obsah navržený pro přístupnost a postupné budování dovedností
- Obsah je navržen pro přístupnost a postupné budování dovedností
### Vzdělávací filozofie
- Přístup založený na projektech
- Časté ověřování znalostí (kvízy)
- Časté kontroly znalostí (kvízy)
- Praktické cvičení v kódování
- Reálné ukázky použití
- Zaměření na základy před frameworky
- Příklady reálných aplikací
- Důraz na základy před rámcemi
### Údržba repozitáře
- Aktivní komunita studentů a přispěvatelů
- Pravidelné aktualizace závislostí a obsahu
- Sledování issues a diskuzí správci
- Aktualizace překladů automatizované přes GitHub Actions
- Správci monitorují issues a diskuze
- Aktualizace překladů automatizovány přes GitHub Actions
### Související zdroje
@ -383,18 +383,18 @@ CO_OP_TRANSLATOR_METADATA:
- [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 s konkrétními projekty
### Práce se specifickými projekty
Pro podrobné instrukce k jednotlivým projektům viz README soubory v:
- `quiz-app/README.md` - Vue 3 aplikace kvízu
- `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 hry založené na Canvasu
- `6-space-game/README.md` - Vývoj her na canvasu
- `9-chat-project/README.md` - Projekt AI chat asistenta
### Struktura Monorepo
### Struktura monorepo
I když se nejedná o tradiční monorepo, tento repozitář obsahuje více nezávislých projektů:
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
@ -403,6 +403,6 @@ I když se nejedná o tradiční monorepo, tento repozitář obsahuje více nez
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Prohlášení o omezení odpovědnosti**:
Tento dokument byl přeložen pomocí AI překladatelské služby [Co-op Translator](https://github.com/Azure/co-op-translator). Ačkoliv 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 důležité informace doporučujeme profesionální lidský překlad. Nejsme odpovědni za jakékoli nedorozumění nebo mylné výklady vyplývající z použití tohoto překladu.
**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.
<!-- 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-06T09:48:33+00:00",
"translation_date": "2026-02-06T11:51:34+00:00",
"source_file": "AGENTS.md",
"language_code": "hu"
},

350
translations/hu/AGENTS.md
Unescape View File

@ -2,42 +2,42 @@
## Projekt áttekintése
Ez egy oktatási tananyag tárhelye, amely kezdők számára tanítja a webfejlesztés alapjait. A tananyag egy átfogó, 12 hetes kurzus, amelyet a Microsoft Cloud Advocates fejlesztett ki, 24 gyakorlati leckével, amelyek a JavaScript, CSS és HTML témákat fedik le.
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.
### Fő összetevők
- **Oktatási tartalom**: 24 strukturált lecke, projekt-alapú modulokba szervezve
- **Gyakorlati projektek**: Terrarium, Gépelős játék, Böngészőbővítmény, Űrjáték, Banki alkalmazás, Kód szerkesztő és AI csevegő asszisztens
- **Interaktív kvízek**: 48 kvíz, mindegyik 3 kérdéssel (lecke előtti/utáni értékelések)
- **Többnyelvű támogatás**: Több mint 50 nyelv automatikus fordítása GitHub Actions segítségével
- **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
- **Technológiák**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI projektekhez)
### Architektúra
- Oktatási tárhely, lecke-alapú struktúrával
- Minden lecke mappa README-t, kód példákat és megoldásokat tartalmaz
- 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ási rendszer GitHub Actions segítségével (co-op-translator)
- Dokumentáció Docsify segítségével, PDF formátumban is elérhető
- Fordító rendszer GitHub Actions-szel (co-op-translator)
- Dokumentáció Docsify-val szolgáltatva és PDF formátumban elérhető
## Beállítási parancsok
Ez a tárhely elsősorban oktatási tartalom fogyasztására szolgál. Konkrét projektekkel való munkához:
Ez a tár elsősorban oktatási tartalom fogyasztására szolgál. Specifikus projektekkel való munkához:
### Fő tárhely beállítása
### Fő tár beállítás
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### Quiz App beállítás (Vue 3 + Vite)
### Kvíz alkalmazás 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 # Build előállítása éles környezethez
npm run build # Építés éles környezethez
npm run lint # ESLint futtatása
```
@ -46,9 +46,9 @@ npm run lint # ESLint futtatása
```bash
cd 7-bank-project/api
npm install
npm start # Indítsa el az API szervert
npm run lint # Futtassa az ESLint-et
npm run format # Formázza a Prettier-rel
npm start # API szerver indítása
npm run lint # ESLint futtatása
npm run format # Formázás Prettier-rel
```
### Böngészőbővítmény projektek
@ -56,18 +56,18 @@ npm run format # Formázza a 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ásokat
# Kövesse a böngészőspecifikus bővítmény betöltési utasításait
```
### Űrjáték projektek
### Űr játék projektek
```bash
cd 6-space-game/solution
npm install
# Nyisd meg az index.html fájlt a böngészőben vagy használd a Live Servert
# Nyissa meg az index.html fájlt a böngészőben vagy használja a Live Server-t
```
### Csevegő projekt (Python backend)
### Csevegőprojekt (Python backend)
```bash
cd 9-chat-project/solution/backend/python
@ -78,35 +78,35 @@ python api.py
## Fejlesztési munkafolyamat
### Tartalomszolgáltatók számára
### Tartalomhozzájárulók számára
1. **Forkold le a tárhelyet** a saját GitHub fiókodba
2. **Klónozd le a forkodat** helyileg
3. **Hozz létre egy új ágat** a változtatásaidhoz
4. Végezzen módosításokat a lecke tartalmán vagy a kód példákon
5. Teszteld a kódváltoztatásokat a megfelelő projekt könyvtárakban
6. Küldj be pull requesteket a hozzájárulási irányelvek szerint
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
### Tanulók számára
1. Forkold vagy klónozd le a tárhelyet
2. Kövesd sorban a lecke könyvtárakat
3. Olvasd el a README fájlokat minden leckéhez
4. Oldd meg a lecke előtti kvízeket a https://ff-quizzes.netlify.app/web/ oldalon
5. Dolgozz a lecke könyvtárakban található kód példákon
6. Teljesítsd a feladatokat és kihívásokat
7. Oldd meg a lecke utáni kvízeket
1. Forkold vagy klónozd le a tárat
2. Sorban haladj a lecke mappákban
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
### Élő fejlesztés
- **Dokumentáció**: Futtasd a `docsify serve` parancsot a gyökérkönyvtárban (3000-es port)
- **Quiz App**: Futtasd az `npm run dev` parancsot a quiz-app könyvtárban
- **Projektek**: Használd a VS Code Live Server kiterjesztést HTML projektekhez
- **API projektek**: Fuss az `npm start` a megfelelő API könyvtárakban
- **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
## Tesztelési utasítások
## Tesztelési útmutató
### Quiz App tesztelése
### Kvíz alkalmazás tesztelése
```bash
cd quiz-app
@ -118,109 +118,109 @@ npm run build # Ellenőrizze, hogy a build sikeres-e
```bash
cd 7-bank-project/api
npm run lint # Ellenőrizze a kód stílusproblémáit
node server.js # Ellenőrizze, hogy a szerver hibák nélkül indul-e
npm run lint # Ellenőrizze a kódstílus problémákat
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árhely, nem tartalmaz átfogó automatizált teszteket
- Manuális tesztelés fókuszai:
- A kód példák lefutnak hiba nélkül
- A dokumentációban szereplő linkek helyesen működnek
- A projekt build sikeresen lefut
- A példák megfelelnek a legjobb gyakorlatoknak
- 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
### Beküldés előtti ellenőrzések
### Beküldés előtti ellenőrzés
- Futtasd az `npm run lint` parancsot a package.json fájlt tartalmazó könyvtárakban
- Ellenőrizd, hogy a markdown linkek érvényesek
- 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
- Ellenőrizd, hogy a fordítások megőrzik a megfelelő struktúrát
- Bizonyosodj meg róla, hogy a fordítások megtartják az eredeti struktúrát
## Kódstílus irányelvek
### JavaScript
- Használj modern ES6+ szintaxist
- Kövesd a projektekben megadott ESLint beállításokat
- Használj jelentést hordozó változó- és függvényneveket az oktatási tisztaság érdekében
- Írj megjegyzéseket a fogalmak magyarázatához a tanulók számára
- Használj Prettier formázást ahol beállították
- 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
### HTML/CSS
- Szemantikus HTML5 elemek használata
- Szemantikus HTML5 elemek
- Reszponzív tervezési elvek
- Egyértelmű osztálynév konvenciók
- CSS technikák magyarázata megjegyzések formájában a tanulók számára
- Egyértelmű osztályelnevezések
- Kommentek a CSS technikák magyarázatához tanulók számára
### Python
- PEP 8 stílus irányelvek betartása
- Tiszta, oktatási célú kód példák
- Típus annotációk, ahol hasznos a tanuláshoz
- PEP 8 stílus irányelvek
- Tiszta, oktatási kód példák
- Típusjelzések, ahol hasznosak a tanuláshoz
### Markdown dokumentáció
- Világos címsor hierarchia
- Nyelv-specifikus kód blokkok
- Linkek további forrásokhoz
- Képernyőképek és képek az `images/` könyvtárakban
- Alternatív szöveg képekhez akadálymentességért
- Á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
### Fájl szervezés
### Fájlszervezés
- A leckék számozva egymás után (1-getting-started-lessons, 2-js-basics, stb.)
- Minden projektnek van `solution/` és gyakran `start/` vagy `your-work/` könyvtára
- Képek leckékre bontva a `images/` mappákban
- 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
- Fordítások a `translations/{language-code}/` struktúrában
## Build és telepítés
### Quiz App telepítés (Azure Static Web Apps)
### Kvíz alkalmazás telepítése (Azure Static Web Apps)
A quiz-app konfigurálva van az Azure Static Web Apps telepítéshez:
A kvíz-app Azure Static Web Apps telepítéshez konfigurált:
```bash
cd quiz-app
npm run build # Létrehozza a dist/ mappát
# Telepítés GitHub Actions munkafolyamattal a main ágra történő push esetén
# Telepítés GitHub Actions munkafolyamaton keresztül a main ágra történő push esetén
```
Azure Static Web Apps konfiguráció:
- **App helye**: `/quiz-app`
Azure Static Web Apps beállítással:
- **Alkalmazás helye**: `/quiz-app`
- **Kimeneti hely**: `dist`
- **Munkafolyamat**: `.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-t
npm run convert # PDF generálása docsból
npm install # Telepítse a docsify-to-pdf csomagot
npm run convert # PDF generálása a docs-ból
```
### Docsify dokumentáció
```bash
npm install -g docsify-cli # A Docsify telepítése globálisan
docsify serve # Futtatás a localhost:3000 címen
npm install -g docsify-cli # Telepítse a Docsify-t globálisan
docsify serve # Szolgáltatás futtatása a localhost:3000 címen
```
### Projekt specifikus build folyamatok
### Projekt-specifikus build folyamatok
Minden projekt könyvtárnak lehet saját build folyamata:
- Vue projektek: `npm run build` létrehozza a produkciós csomagokat
- Statikus projektek: nincs build lépés, a fájlokat közvetlenül szolgálja ki
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
## Pull request irányelvek
## Pull Request irányelvek
### Cím formátum
Használj egyértelmű, leíró címeket, amelyek a változtatás területét jelzik:
- `[Quiz-app] Új kvíz hozzáadva az X leckéhez`
- `[Lesson-3] Elírás javítása a terrarium projektben`
- `[Translation] Spanyol fordítás hozzáadva az 5. leckéhez`
Használj világos, leíró címeket, amelyek mutatják 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`
- `[Translation] Spanyol fordítás hozzáadása az 5. leckéhez`
- `[Docs] Beállítási utasítások frissítése`
### Kötelező ellenőrzések
@ -228,51 +228,51 @@ Használj egyértelmű, leíró címeket, amelyek a változtatás területét je
PR beküldése előtt:
1. **Kódminőség**:
- Futtasd az `npm run lint` a érintett projekt könyvtárakban
- Javíts minden lint hibát és figyelmeztetést
- Futtasd az `npm run lint` parancsot az érintett projektkönyvtárakban
- Javítsd az összes lint hibát és figyelmeztetést
2. **Build ellenőrzés**:
- Futtasd az `npm run build` ahol alkalmazható
- Biztosítsd, hogy nincs build hiba
- Futtasd az `npm run build` parancsot, ha alkalmazható
- Bizonyosodj meg arról, hogy nincs build hiba
3. **Link ellenőrzés**:
3. **Link validálás**:
- Teszteld az összes markdown linket
- Ellenőrizd, hogy a képek hivatkozásai működnek
- Ellenőrizd a képhivatkozások működését
4. **Tartalom átnézés**:
- Ellenőrizd helyesírás és nyelvhelyesség szempontjából
- Biztosítsd, hogy a kód példák helyesek és oktatók
- Bizonyosodj meg arról, hogy a fordítások megőrzik az eredeti jelentést
- 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
### Hozzájárulási követelmények
- Beleegyezés a Microsoft CLA-ba (automatikus ellenőrzés az első PR-nél)
- Kövesd a [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) szabályzatát
- Lásd a [CONTRIBUTING.md](./CONTRIBUTING.md) irányelveit részletesen
- Hibaszámokat tüntess fel a PR leírásában, ha van ilyen
- 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
### Áttekintési folyamat
### Felülvizsgálati folyamat
- A PR-eket a karbantartók és a közösség is átnézi
- Oktatási érthetőség prioritást élvez
- A kód példáknak követniük kell a jelenlegi legjobb gyakorlatokat
- A fordítások pontosságát és kulturális megfelelőségét is átnézik
- PR-eket karbantartók és a közösség nézi át
- Oktatási érthetőség az elsődleges szempont
- 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ási rendszer
## Fordító rendszer
### Automatikus fordítás
- GitHub Actions használata co-op-translator munkafolyamattal
- GitHub Actions használatával co-op-translator munkafolyamat
- 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
### Kézi fordítási javítások hozzáadása
### Manuális fordítási javítások hozzáadása
1. Keress rá a fájlra a `translations/{language-code}/` könyvtárban
2. Végezz javításokat, miközben megőrzöd a struktúrát
3. Biztosítsd, hogy a kód példák továbbra is működnek
4. Teszteld a lokalizált kvíz tartalmakat
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
### Fordítási metaadatok
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
-->
```
## Hibakeresés és problémamegoldás
## Hibakeresés és hibaelhárítás
### Gyakori problémák
### Gyakoribb problémák
**A Quiz app nem indul el**:
- Ellenőrizd a Node.js verziót (javasolt v14+)
- Töröld a `node_modules` és `package-lock.json` fájlokat, majd futtasd újra az `npm install` parancsot
- Ellenőrizd, nincs-e port ütközés (alapértelmezetten a Vite a 5173 portot használja)
**A kvíz alkalmazás nem indul**:
- 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)
**API szerver nem indul el**:
- Ellenőrizd, hogy a Node.js verzió megfelel-e az elvártnak (node >=10)
- Ellenőrizd, nincs-e már elfoglalva a port
- Győződj meg róla, hogy minden függőség telepítve van az `npm install` segítségével
**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
**Böngészőbővítmény nem töltődik be**:
- Ellenőrizd a manifest.json helyes formátumát
- Nézd meg a böngésző konzolt hibákért
- Kövesd a böngésző specifikus bővítmény telepítési útmutatóját
- 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
**Python chat projekt problémák**:
- Ellenőrizd, hogy az OpenAI csomag telepítve van: `pip install openai`
**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
- Ellenőrizd a GitHub Models hozzáférési engedélyeket
- Nézd meg a GitHub Modellekhez való hozzáférési jogosultságokat
**Docsify nem szolgálja ki a dokumentációt**:
**Docsify nem szolgáltat dokumentációt**:
- Telepítsd globálisan a docsify-cli-t: `npm install -g docsify-cli`
- Fuss a tárhely gyökérkönyvtárából
- Futtasd a tár gyökeréből
- Ellenőrizd, hogy a `docs/_sidebar.md` létezik
### Fejlesztői környezet tippek
### Fejlesztői környezeti tippek
- Használd a VS Code Live Server kiterjesztést HTML projektekhez
- Telepítsd az ESLint és Prettier kiterjesztéseket az egységes formázáshoz
- Használd a böngésző fejlesztői eszközeit JavaScript hibakereséshez
- Vue projektekhez telepítsd a Vue DevTools böngésző kiterjesztést
- 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á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
- A nagyon sok fordított fájl (50+ nyelv) miatt a teljes klón nagy méretű
- 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`
- Kizárhatod a fordításokat a keresésekből angol tartalom fejlesztésekor
- A build folyamatok lehetnek lassúak az első futtatáskor (npm install, Vite build)
- Fordításokat ne keresd át angol tartalom szerkesztésekor
- Build folyamatok lassúak lehetnek első futtatáskor (npm install, Vite build)
## Biztonsági szempontok
### Környezeti változók
- API kulcsokat soha ne committolj a tárhelyre
- Használj `.env` fájlokat (már benne vannak a `.gitignore`-ban)
- Dokumentáld a szükséges környezeti változókat a projekt README fájljaiban
- 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
### Python projektek
- Használj virtuális környezeteket: `python -m venv venv`
- Használj virtuális környezetet: `python -m venv venv`
- Tartsd naprakészen a függőségeket
- A GitHub tokeneknek minimális jogosultságokat kell adni
- GitHub tokeneknek csak minimálisan szükséges jogosultságokat adj
### GitHub Models hozzáférés
### GitHub Modellekhez való hozzáférés
- Személyes hozzáférési tokenek (PAT) kellenek GitHub Models használathoz
- Személyes hozzáférési tokenek (PAT) szükségesek a GitHub Modellekhez
- A tokeneket környezeti változóként tárold
- Soha ne committold a tokeneket vagy hitelesítő adatokat
- Soha ne kövesd be a tokeneket vagy hitelesítő adatokat
## További megjegyzések
## Egyéb megjegyzések
### Célközönség
- Teljesen kezdő webfejlesztők
- Diákok és önálló tanulók
- Tanárok, akik az oktatási anyagot osztálytermekben használják
- A tartalom akadálymentes és fokozatos képességfejlesztésre tervezett
- 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
### Oktatási filozófia
- Projekt-alapú tanulási megközelítés
- Projektalapú tanulási megközelítés
- Gyakori tudásellenőrzések (kvízek)
- Gyakorlati kódolási feladatok
- Valós életből vett alkalmazási példák
- Az alapokra helyezett hangsúly a keretrendszerek előtt
- Valós alkalmazási példák
- Az alapokra fókuszálás a keretrendszerek előtt
### Tárhely karbantartás
### Tár karbantartás
- Aktív tanulói és hozzájárulói közösség
- Rendszeres frissítések a függőségekhez és tartalomhoz
- Hibák és viták felügyelete karbantartók által
- Fordítási frissítések automatizálva GitHub Actions segítségével
- 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
### Kapcsolódó források
- [Microsoft Learn modulok](https://docs.microsoft.com/learn/)
- [Student Hub források](https://docs.microsoft.com/learn/student-hub/)
- [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
- További tanfolyamok: Generatív AI, Adattudomány, ML, IoT tananyagok állnak rendelkezésre
- Egyéb kurzusok: Generative AI, Data Science, ML, IoT tananyagok elérhetők
### Konkrét projektekkel való munka
### Specifikus projektekkel való munka
Részletes útmutatók az egyes projektekhez a megfelelő README fájlokban találhatók:
- `quiz-app/README.md` – Vue 3 alapú 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` – Canvas alapú játék fejlesztés
- `9-chat-project/README.md` – AI csevegő asszisztens projekt
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
- `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
### Monorepo struktúra
### Monorepo szerkezet
Habár nem egy hagyományos monorepo, ez a tárhely több független projektet tartalmaz:
Bár nem hagyományos monorepóról van szó, ez a tár több önálló projektet tartalmaz:
- Minden lecke önálló
- A projektek nem osztanak meg függőségeket
- Egyedi projekteken dolgozhatsz anélkül, hogy másokat befolyásolnál
- Az egész tárhely klónozásával megkaphatod a teljes tananyagot
- 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
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Kizáró nyilatkozat**:
Ez a dokumentum az AI fordítási szolgáltatás, a [Co-op Translator](https://github.com/Azure/co-op-translator) segítségével készült. Bár igyekszünk a pontosságra, kérjük, vegye figyelembe, hogy az automatikus fordítások hibákat vagy pontatlanságokat tartalmazhatnak. Az eredeti dokumentum a saját nyelvén tekintendő hivatalos forrásnak. Kritikus információk esetén szakmai emberi fordítást javaslunk. Nem vállalunk felelősséget az ebből eredő félreértésekért vagy téves értelmezésekért.
**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.
<!-- 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-06T09:51:13+00:00",
"translation_date": "2026-02-06T11:53:58+00:00",
"source_file": "AGENTS.md",
"language_code": "sk"
},

430
translations/sk/AGENTS.md
Unescape View File

@ -2,27 +2,27 @@
## Prehľad projektu
Toto je repozitár vzdelávacieho 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, obsahujúci 24 praktických lekcií pokrývajúcich JavaScript, CSS a HTML.
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.
### Kľúčové komponenty
- **Vzdelávací obsah**: 24 štruktúrovaných lekcií usporiadaných do modulov založených na projektoch
- **Praktické projekty**: Terrárium, Hra na písanie, Rozšírenie prehliadača, Hra vo vesmíre, Banková aplikácia, Editor kódu a AI Chat asistent
- **Interaktívne kvízy**: 48 kvízov s 3 otázkami každý (pred a po lekcii)
- **Podpora viacerých jazykov**: Automatizované preklady do 50+ jazykov pomocou 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**: 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)
### Architektúra
- Vzdelávací repozitár so štruktúrou založenou na lekciách
- Každá lekcia má priečinok s README, príkladmi kódu a riešeniami
- Samostatné projekty v oddelených adresároch (quiz-app, rôzne lekčné projekty)
- Prekladový systém využívajúci GitHub Actions (co-op-translator)
- Dokumentácia poskytovaná cez Docsify a dostupná aj vo formáte PDF
- 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
## Príkazy na nastavenie
Tento repozitár je primárne určený na konzumáciu vzdelávacieho obsahu. Pre prácu s konkrétnymi projektmi:
Tento repozitár je primárne určený na konzumovanie vzdelávacieho obsahu. Pre prácu s konkrétnymi projektmi:
### Nastavenie hlavného repozitára
@ -30,44 +30,44 @@ Tento repozitár je primárne určený na konzumáciu vzdelávacieho obsahu. Pre
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### Nastavenie Quiz App (Vue 3 + Vite)
### Nastavenie Quiz Aplikácie (Vue 3 + Vite)
```bash
cd quiz-app
npm install
npm run dev # Spustiť vývojový server
npm run build # Vytvoriť build pre produkciu
npm run build # Vytvoriť verziu 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
npm install
npm start # Spustiť API server
npm run lint # Spustiť ESLint
npm run format # Formátovať pomocou Prettier
npm run format # Naformátovať pomocou Prettier
```
### Projekty rozšírenia prehliadača
### Projekty Rozšírení prehliadača
```bash
cd 5-browser-extension/solution
npm install
# Postupujte podľa pokynov pre načítanie rozšírení špecifických pre prehliadač
# Postupujte podľa pokynov na načítanie rozšírení špecifických pre prehliadač
```
### Projekty hry vo vesmíre
### Projekty Hry v priestore
```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
@ -75,123 +75,123 @@ pip install openai
# Nastavte premennú prostredia GITHUB_TOKEN
python api.py
```
## Vývojový pracovný postup
## Vývojový pracovný tok
### Pre prispievateľov obsahu
1. **Forknite repozitár** do svojho GitHub účtu
2. **Klonujte fork** lokálne
3. **Vytvorte novú vetvu** pre svoje zmeny
4. Urobte zmeny v obsahu lekcií alebo príkladoch kódu
5. Testujte zmeny v relevantných projektových adresároch
6. Odosielajte pull requesty podľa pravidiel pre príspevky
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
### Pre študentov
1. Forknite alebo klonujte repozitár
2. Postupujte po lekčných adresároch za sebou
3. Prečítajte si README súbory pre každú lekciu
4. Dokončite predlekcové kvízy na https://ff-quizzes.netlify.app/web/
5. Prejdite príklady kódu v adresároch lekcií
6. Splňte zadania a výzvy
7. Vyplňte pookrajové kvízy
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
### Živý vývoj
### Priame vývojové prostredie
- **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
## Pokyny na testovanie
## Inštrukcie na testovanie
### Testovanie Quiz App
### Testovanie Quiz Aplikácie
```bash
cd quiz-app
npm run lint # Skontrolujte problémy so štýlom kódu
npm run build # Overte úspešnosť zostavenia
npm run build # Overte, či je zostavenie úspešné
```
### Testovanie Bank API
```bash
cd 7-bank-project/api
npm run lint # Skontrolujte problémy so štýlom kódu
node server.js # Overiť, či server štartuje bez chýb
node server.js # Overte, či server štartuje bez chýb
```
### Všeobecný prístup k testovaniu
- Je to vzdelávací repozitár bez komplexných automatizovaných testov
- Manuálne testovanie sa zameriava na:
- Bežanie príkladov kódu bez chýb
- Funkčnosť odkazov v dokumentácii
- Úspešné zostavenie projektov
- Príklady dodržiavajú osvedčené postupy
- 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
### Kontroly pred odoslaním
- Spustite `npm run lint` v adresároch s package.json
- Overte platnosť odkazov v markdown súboroch
- Testujte príklady kódu v prehliadači alebo Node.js
- Skontrolujte, či preklady zachovávajú správnu štruktúru
- 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
## Pokyny pre štýl kódu
## Pravidlá štýlu kódu
### JavaScript
- Používajte modernú syntax ES6+
- Dodržiavajte štandardné ESLint konfigurácie v projektoch
- Používajte zmysluplné mená premenných a funkcií pre vzdelávaciu zrozumiteľnosť
- Pridávajte komentáre vysvetľujúce koncepty pre študentov
- Formátujte pomocou Prettier tam, kde je nakonfigurovaný
- 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é
### HTML/CSS
- Semantické HTML5 elementy
- Zásady responzívneho dizajnu
- Jasné pomenovanie tried
- Komentáre vysvetľujúce CSS techniky pre študentov
- Semantické HTML5 prvky
- Princípy responzívneho dizajnu
- Jasné pomenovanie CSS tried
- Komentáre vysvetľujúce CSS techniky pre študentov
### Python
- Štýlové smernice podľa PEP 8
- Jasné, vzdelávacie príklady kódu
- Typové anotácie tam, kde sú užitočné pre učenie
- Dodržiavajte PEP 8 štýlové smernice
- Čisté, vzdelávacie príklady kódu
- Typové anotácie tam, kde pomáhajú pri učení
### Markdown dokumentácia
### Markdown Dokumentácia
- Jasná hierarchia nadpisov
- Kódové bloky so špecifikáciou jazyka
- Odkazy na ďalšie zdroje
- Snímky obrazovky a obrázky v adresároch `images/`
- Alternatívny text pre obrázky kvôli prístupnosti
- 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ť
### Organizácia súborov
- Lekcie číslované postupne (1-getting-started-lessons, 2-js-basics, atď.)
- Každý projekt má `solution/` a často aj `start/` alebo `your-work/` adresáre
- Obrázky uložené v lekčne špecifických priečinkoch `images/`
- Preklady v štruktúre `translations/{jazykový-kód}/`
- 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}/`
## Skladanie a nasadenie
## Build a Nasadenie
### Nasadenie Quiz App (Azure Static Web Apps)
### Nasadenie Quiz Aplikácie (Azure Static Web Apps)
quiz-app je nakonfigurovaná pre nasadenie pomocou Azure Static Web Apps:
Quiz-app je nakonfigurovaný pre nasadenie ako Azure Static Web Apps:
```bash
cd quiz-app
npm run build # Vytvára priečinok dist/
# Nasadzuje cez workflow GitHub Actions pri pushi do main
# Nasadzuje cez workflow GitHub Actions pri push do main
```
Konfigurácia Azure Static Web Apps:
- **Umiestnenie aplikácie**: `/quiz-app`
- **Výstupné umiestnenie**: `dist`
- **Pracovný tok**: `.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štalujte Docsify globálne
npm install -g docsify-cli # Nainštalovať Docsify globálne
docsify serve # Spustiť na localhost:3000
```
### Projektovo špecifické buildy
### Zostavenie špecifické pre projekt
Každý projekt 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 podávajú priamo
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
## Pokyny pre pull requesty
## Pravidlá pre pull requesty
### Formát názvu
Používajte jasné, popisné názvy uvádzajúce oblasť zmeny:
- `[Quiz-app] Pridaj nový kvíz pre lekciu X`
- `[Lesson-3] Oprav preklep v projekte terrarium`
- `[Translation] Pridaj španielsky preklad pre lekciu 5`
- `[Docs] Aktualizuj inštrukcie na nastavenie`
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`
### Požadované kontroly
### 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
1. **Kvalita kódu**:
- Spustite `npm run lint` v ovplyvnených projektových adresároch
- Opravte všetky chyby a varovania z lintovania
2. **Overenie buildovania**:
- Spustite `npm run build` ak je to potrebné
- Zabezpečte, že nie sú žiadne chyby pri buildovaní
2. **Overenie buildovania**:
- Spustite `npm run build` pokiaľ je to relevantné
- Uistite sa, že nie sú žiadne chyby pri buildovaní
3. **Overenie odkazov**:
- Testujte všetky odkazy v markdown
- Skontrolujte funkčnosť odkazov na obrázky
3. **Validácia odkazov**:
- Otestujte všetky markdown odkazy
- Overte, že odkazy na obrázky fungujú
4. **Kontrola obsahu**:
- Korektúra pravopisu a gramatiky
- Overte správnosť a vzdelávaciu hodnotu príkladov kódu
- Skontrolujte presnosť prekladov
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
### Požiadavky na príspevky
- Súhlas s Microsoft CLA (automatická kontrola pri prvom PR)
- Dodržiavanie [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Pozrite si [CONTRIBUTING.md](./CONTRIBUTING.md) pre podrobné pokyny
- V prípade potreby odkazujte čísla issue v popise PR
- 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é
### Proces revízie
### Proces preskúmania
- PR kontrolujú maintaineri a komunita
- Uprednostňuje sa vzdelávacia zrozumiteľnosť
- Príklady kódu by mali dodržiavať aktuálne osvedčené postupy
- Preklady sa kontrolujú na presnosť a kultúrnu vhodnosť
- 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
## Prekladový systém
### Automatický preklad
### Automatizovaný preklad
- Používa GitHub Actions s pracovným tokom co-op-translator
- Automatický preklad do 50+ jazykov
- Zdrojové súbory v hlavných adresároch
- Preložené súbory v adresároch `translations/{jazykový-kód}/`
- 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}/`
### Pridávanie manuálnych vylepšení prekladov
### Pridávanie manuálnych vylepšení prekladu
1. Nájdite súbor v `translations/{jazykový-kód}/`
2. Vykonajte úpravy s zachovaním štruktúry
3. Zabezpečte funkčnosť príkladov kódu
4. Otestujte lokalizovaný kvízový obsah
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
### Metaúdaje prekladov
### Metaúdaje prekladu
Preložené súbory obsahujú metaúdaje:
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 app sa nespúšťa**:
- Skontrolujte verziu Node.js (odporúčaná v14+)
- Vymažte `node_modules` a `package-lock.json`, spustite `npm install` znovu
- Skontrolujte konflikty portov (predvolený port pre Vite je 5173)
**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)
**API server sa nespúšťa**:
- Overte minimálnu verziu Node.js (node >=10)
- Skontrolujte, či port nie je už obsadený
- Uistite sa, že všetky závislosti sú nainštalované pomocou `npm install`
**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`
**Rozšírenie prehliadača sa nenačíta**:
- Overte správne naformátovanie manifest.json
- Skontrolujte chyby v konzole prehliadača
- Dodržiavajte inštrukcie na inštaláciu špecifické pre prehliadač
**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í
**Problémy s Python chat projektom**:
- Uistite sa, že je nainštalovaný balík OpenAI: `pip install openai`
- Overte, či je nastavená premenná prostredia GITHUB_TOKEN
- Skontrolujte povolenia prístupu ku GitHub Models
**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
**Docsify neslúži dokumentáciu**:
- Nainštalujte docsify-cli globálne: `npm install -g docsify-cli`
- Spustite z koreňového adresára repozitára
- Skontrolujte, že existuje `docs/_sidebar.md`
**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`
### 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 prehliadača na ladenie JavaScriptu
- Pre Vue projekty nainštalujte Vue DevTools rozšírenie do prehliadača
- 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
### Výkonnostné úvahy
- Veľký počet preložených súborov (50+ jazykov) znamená veľké full klony
- Použite shallow clone, ak pracujete len s obsahom: `git clone --depth 1`
- Pri práci na anglickom obsahu vynechajte preklady z vyhľadávania
- Build procesy môžu byť pri prvom spustení pomalé (npm install, Vite build)
- 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)
## Bezpečnostné úvahy
## Bezpečnostné upozornenia
### Premenné prostredia
### Environmentálne premenné
- API kľúče by nikdy nemali byť ukladané do repozitára
- Používajte `.env` súbory (už zahrnuté v `.gitignore`)
- Požadované premenné prostredia zdokumentujte v README projektov
- 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
### 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é povolenia
- 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
### Prístup ku GitHub Models
### Prístup k GitHub Models
- Pre prístup ku GitHub Models sú potrebné Personal Access Tokens (PAT)
- Tokeny ukladajte ako premenné prostredia
- Nikdy neukladajte tokeny alebo prihlasovacie údaje do repozitára
- 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
## Ďalšie poznámky
## Dodatočné poznámky
### Cieľová skupina
- Úplní začiatočníci vo webovom vývoji
- Študenti a samoukovia
- Učitelia používajúci kurikulum v triedach
- Obsah je navrhnutý pre prístupnosť a postupné budovanie zručností
- Ú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í
### Vzdelávacia filozofia
- Prístup učenia založený na projektoch
- Časté overenia vedomostí (kvízy)
- Praktické cvičenia programovania
- Príklady reálnych aplikácií
- Zameranie na základy pred frameworkmi
- 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
### Údržba repozitára
- Aktívna komunita študentov a prispievateľov
- Pravidelné aktualizácie závislostí a obsahu
- Údržba prostredníctvom sledovania issue a diskusií
- Aktualizácie prekladov automatizované cez GitHub Actions
- 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
### Súvisiace zdroje
- [Microsoft Learn moduly](https://docs.microsoft.com/learn/)
- [Študentské centrum zdrojov](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 kurikula dostupné
- [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é
### Práca s konkrétnymi projektmi
Podrobné inštrukcie pre jednotlivé projekty nájdete v README súboroch:
- `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 na canvas
- `9-chat-project/README.md` - Projekt AI chat asistenta
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
### Štruktúra monorepa
Aj keď to nie je tradičné monorepo, tento repozitár obsahuje niekoľko nezávislých projektov:
- Každá lekcia je samostatná
- Projekty nesdielajú závislosti
- Pracujte na jednotlivých projektoch bez vplyvu na ostatné
- Naklonujte celý repozitár pre kompletný zážitok kurikula
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
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Vylúčenie zodpovednosti**:
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ť, vezmite prosím na vedomie, že automatické 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 dôležité informácie sa odporúča profesionálny ľudský preklad. Nie sme zodpovední za akékoľvek nedorozumenia alebo nesprávne interpretácie, ktoré môžu vzniknúť použitím tohto prekladu.
**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.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->
Write Preview
Loading…
Cancel
Save