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

pull/1774/head
localizeflow[bot] 6 months ago
parent 4156bd2331
commit 3dd0c15c92

@ -1,7 +1,7 @@
{ {
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": { "1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8", "original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-06T16:02:36+00:00", "translation_date": "2026-03-27T19:42:12+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md", "source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "cs" "language_code": "cs"
}, },
@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T16:06:41+00:00", "translation_date": "2026-03-27T19:45:54+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "cs" "language_code": "cs"
}, },

@ -2,27 +2,27 @@
## Přehled projektu ## Přehled projektu
Toto je vzdělávací repozitář pro výuku základů webového vývoje pro začátečníky. Kurikul 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 představuje komplexní 12týdenní kurz vyvinutý Microsoft Cloud Advocates, obsahující 24 praktických lekcí pokrývajících JavaScript, CSS a HTML.
### Klíčové prvky ### Klíčové komponenty
- **Vzdělávací obsah**: 24 strukturovaných lekcí organizovaných do modulů založených na projektech - **Vzdělávací obsah**: 24 strukturovaných lekcí organizovaný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 - **Praktické projekty**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor a AI Chat Assistant
- **Interaktivní kvízy**: 48 kvízů se 3 otázkami každý (hodnocení před a po lekci) - **Interaktivní kvízy**: 48 kvízů s 3 otázkami každý (před/po lekci)
- **Podpora více jazyků**: Automatické překlady pro více než 50 jazyků pomocí GitHub Actions - **Podpora více jazyků**: 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) - **Technologie**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (pro AI projekty)
### Architektura ### Architektura
- Vzdělávací repozitář s lekční strukturou - Vzdělávací repozitář s lekčně založenou strukturou
- Každá složka lekce obsahuje README, příklady kódu a řešení - 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) - Samostatné projekty v oddělených adresářích (quiz-app, různé projekty lekcí)
- Překladový systém využívající GitHub Actions (co-op-translator) - Překladový systém využívající GitHub Actions (co-op-translator)
- Dokumentace podávána přes Docsify a dostupná jako PDF - Dokumentace poskytována přes Docsify a dostupná i jako PDF
## Příkazy pro nastavení ## Příkazy pro nastavení
Tento repozitář je primárně určen pro konzumaci vzdělávacího obsahu. 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:
### Nastavení hlavního repozitáře ### Nastavení hlavního repozitáře
@ -41,7 +41,7 @@ npm run build # Sestavit pro produkci
npm run lint # Spustit ESLint npm run lint # Spustit ESLint
``` ```
### Bankovní API projekt (Node.js + Express) ### Bankovní projekt API (Node.js + Express)
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
@ -51,7 +51,7 @@ npm run lint # Spustit ESLint
npm run format # Formátovat pomocí Prettier npm run format # Formátovat pomocí Prettier
``` ```
### Projekty rozšíření prohlížeče ### Projekty pro rozšíření prohlížeče
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
@ -67,7 +67,7 @@ npm install
# Otevřete index.html v prohlížeči nebo použijte Live Server # Otevřete index.html v prohlížeči nebo použijte Live Server
``` ```
### Chatovací projekt (Python backend) ### Chat projekt (Python backend)
```bash ```bash
cd 9-chat-project/solution/backend/python cd 9-chat-project/solution/backend/python
@ -80,107 +80,107 @@ python api.py
### Pro přispěvatele obsahu ### Pro přispěvatele obsahu
1. **Rozvětvěte (fork) repozitář** do svého GitHub účtu 1. **Vytvořte fork repozitáře** do svého GitHub účtu
2. **Naklonujte svůj fork** lokálně 2. **Naklonujte svojí větev** lokálně
3. **Vytvořte novou větev** pro své změny 3. **Vytvořte novou větev** pro své změny
4. Proveďte změny v obsahu lekce nebo příkladech kódu 4. Proveďte změny v obsahu lekcí nebo příkladech kódu
5. Testujte kódové změny v příslušných projektových složkách 5. Otestujte změny v příslušných projektech
6. Podávejte pull requesty podle pokynů pro přispě 6. Odešlete pull requesty dle zásad přispívá
### Pro studenty ### Pro studenty
1. Rozvětvěte nebo naklonujte repozitář 1. Vytvořte fork nebo klonujte repozitář
2. Procházejte lekční složky postupně 2. Postupujte sekvenčně do adresářů lekcí
3. Čtěte README soubory pro každou lekci 3. Čtěte README soubory každé lekce
4. Dokončete předběžné kvízy na https://ff-quizzes.netlify.app/web/ 4. Dokončete před/po- lekční kvízy na https://ff-quizzes.netlify.app/web/
5. Procházejte příklady kódu v lekčních složkách 5. Procvičujte si příklady kódu v adresářích lekcí
6. Dokončete úkoly a výzvy 6. Plňte úkoly a výzvy
7. Absolvujte kvízy po lekci 7. Absolvujte závěrečné kvízy
### Živý vývoj ### Živý vývoj
- **Dokumentace**: Spusťte `docsify serve` v rootu (port 3000) - **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 - **Quiz App**: Spusťte `npm run dev` v adresáři quiz-app
- **Projekty**: Použijte VS Code Live Server rozšíření pro HTML projekty - **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 - **API projekty**: Spusťte `npm start` v příslušných API složkách
## Instrukce testování ## Testování
### Testování Quiz App ### Testování Quiz App
```bash ```bash
cd quiz-app cd quiz-app
npm run lint # Zkontrolujte problémy se stylem kódu npm run lint # Zkontrolujte problémy se stylem kódu
npm run build # Ověřte, že kompilace proběhla úspěšně npm run build # Ověřte, že sestavení proběhlo úspěšně
``` ```
### Testování Bank API ### Testování Bank API
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm run lint # Zkontrolujte problémy s stylem kódu npm run lint # Zkontrolujte problémy se stylem kódu
node server.js # Ověřte, že server startuje bez chyb node server.js # Ověřte, zda server startuje bez chyb
``` ```
### Obecný přístup k testování ### Obecný přístup k testování
- Toto je vzdělávací repozitář bez rozsáhlých automatizovaných testů - Tento repozitář je vzdělávací a nemá komplexní automatizované testy
- Manuální testování se zaměřuje na: - Manuální testování se zaměřuje na:
- Příklady kódu bez chyb při spuštění - Spuštění příkladů kódu bez chyb
- Funkčnost odkazů v dokumentaci - Funkčnost odkazů v dokumentaci
- Úspěšné sestavení projektů - Úspěšné sestavení projektů
- Příklady odpovídající nejlepší praxi - Dodržování osvědčených postupů v příkladech
### Kontroly před odesláním ### Předodeslání kontroly
- Spusťte `npm run lint` ve složkách s package.json - Spusťte `npm run lint` v adreřích s package.json
- Ověřte platnost odkazů v markdownu - Ověřte platnost markdown odkazů
- Testujte příklady kódu v prohlížeči nebo Node.js - Testujte příklady kódu v prohlížeči nebo Node.js
- Zkontrolujte, že překlady zachovávají správnou strukturu - Zkontrolujte, že překlady zachovávají správnou strukturu
## Zásady stylu kódu ## Směrnice pro styl kódu
### JavaScript ### JavaScript
- Používejte moderní syntaxi ES6+ - Používejte moderní ES6+ syntaxi
- Dodržujte standardní ESLint konfigurace v projektech - Dodržujte standardní ESLint nastavení v projektech
- Používejte smysluplné názvy proměnných a funkcí pro vzdělávací přehlednost - Používejte smysluplná jména proměnných a funkcí pro lepší porozumění
- Přidávejte komentáře vysvětlující koncepty pro studenty - Přidávejte komentáře vysvětlující pojmy pro studenty
- Formátujte pomocí Prettier tam, kde je nastaveno - Formátujte kód pomocí Prettier tam, kde je nastaveno
### HTML/CSS ### HTML/CSS
- Sémantické HTML5 elementy - Semantické elementy HTML5
- Principy responzivního designu - Principy responzivního designu
- Jasné konvence pojmenování tříd - Jasné konvence pojmenování tříd
- Komentáře vysvětlující CSS techniky pro studenty - Komentáře vysvětlující CSS techniky pro studenty
### Python ### Python
- Dodržování PEP 8 stylu - Dodržujte stylové pravidla PEP 8
- Jasné, vzdělávací příklady kódu - Jasné, vzdělávací příklady kódu
- Typové anotace tam, kde je to pro učení užitečné - Používejte typové anotace tam, kde je to pro učení užitečné
### Markdown dokumentace ### Markdown dokumentace
- Jasná hierarchie nadpisů - Jasná hierarchie nadpisů
- Kódové bloky s určením jazyka - Bloky kódu s určením jazyka
- Odkazy na další zdroje - Odkazy na další zdroje
- Snímky obrazovky a obrázky ve složkách `images/` - Snímky obrazovky a obrázky ve složce `images/`
- Alt texty pro obrázky pro přístupnost - Alt text pro obrázky pro zpřístupnění
### Organizace souborů ### Organizace souborů
- Lekce číslovány sekvenčně (1-getting-started-lessons, 2-js-basics, atd.) - Lekce číslované sekvenčně (1-getting-started-lessons, 2-js-basics apod.)
- Každý projekt má složky `solution/` a často `start/` nebo `your-work/` - Každý projekt má složky `solution/` a často `start/` nebo `your-work/`
- Obrázky uložené v lekčně specifických složkách `images/` - Obrázky uložené ve složkách `images/` jednotlivých lekcí
- Překlady ve struktuře `translations/{jazykový-kód}/` - Překlady ve struktuře `translations/{language-code}/`
## Sestavení a nasazení ## Build a nasazení
### Nasazení Quiz App (Azure Static Web Apps) ### Nasazení Quiz App (Azure Static Web Apps)
Quiz-app je konfigurován pro nasazení na Azure Static Web Apps: Quiz-app je nakonfigurována pro nasazení na Azure Static Web Apps:
```bash ```bash
cd quiz-app cd quiz-app
@ -190,93 +190,93 @@ npm run build # Vytváří složku dist/
Konfigurace Azure Static Web Apps: Konfigurace Azure Static Web Apps:
- **Umístění aplikace**: `/quiz-app` - **Umístění aplikace**: `/quiz-app`
- **Umístění výstupu**: `dist` - **Výstupní složka**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Generování PDF dokumentace ### Generování PDF dokumentace
```bash ```bash
npm install # Nainstalujte docsify-to-pdf npm install # Nainstalujte docsify-to-pdf
npm run convert # Vygenerujte PDF z docs npm run convert # Vygenerujte PDF z dokumentace
``` ```
### Docsify dokumentace ### Docsify dokumentace
```bash ```bash
npm install -g docsify-cli # Nainstalujte Docsify globálně npm install -g docsify-cli # Nainstalujte Docsify globálně
docsify serve # Spustit na localhost:3000 docsify serve # Přes server na localhost:3000
``` ```
### Sestavení specifická pro projekt ### Buildy specifické pro projekty
Každý projekt může mít vlastní build proces: Každý adresář projektu může mít vlastní build proces:
- Vue projekty: `npm run build` vytváří produkční balíčky - 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, soubory se servírují přímo
## Pokyny pro pull requesty ## Směrnice pro Pull Requesty
### Formát názvu ### Formát názvu
Používejte jasné, popisné názvy uvádějící oblast změn: Používejte jasné, popisné názvy vyjadřující oblast změny:
- `[Quiz-app] Přidat nový kvíz pro lekci X` - `[Quiz-app] Přidat nový kvíz pro lekci X`
- `[Lesson-3] Opravit překlep v projektu terrária` - `[Lesson-3] Opravit překlep v projektu terrarium`
- `[Translation] Přidat španělský překlad pro lekci 5` - `[Translation] Přidat španělský překlad pro lekci 5`
- `[Docs] Aktualizovat instrukce pro nastavení` - `[Docs] Aktualizovat instrukce nastavení`
### Povinné kontroly ### Povinné kontroly
Před odesláním PR: Před odesláním PR:
1. **Kvalita kódu**: 1. **Kvalita kódu**:
- Spusťte `npm run lint` v ovlivněných projektových složkách - Spusťte `npm run lint` v dotčených projektech
- Opravte všechny lintovací chyby a varování - Opravte všechny chyby a varování
2. **Ověření sestavení**: 2. **Ověření buildů**:
- Spusťte `npm run build`, pokud je relevantní - Spusťte `npm run build` kde je to potřeba
- Zajistěte, že nejsou chyby sestavení - Zajistěte bezchybný build
3. **Ověření odkazů**: 3. **Ověření odkazů**:
- Otestujte všechny markdown odkazy - Otestujte všechny markdown odkazy
- Ověřte fungování referencí obrázků - Zkontrolujte funkčnost odkazů na obrázky
4. **Kontrola obsahu**: 4. **Kontrola obsahu**:
- Korektury pravopisu a gramatiky - Korektura pravopisu a gramatiky
- Ověření správnosti a vzdělávací hodnoty příkladů kódu - Ověřte správnost a edukační hodnotu příkladů kódu
- Ověření, že překlady zachovávají původní význam - Překlady musí zachovat původný význam
### Požadavky na přispění ### Požadavky na příspěvky
- Souhlas se smlouvou Microsoft CLA (automatická kontrola při prvním PR) - Souhlas s Microsoft CLA (automatická kontrola při prvním PR)
- Dodržujte [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) - Dodržovat [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Viz [CONTRIBUTING.md](./CONTRIBUTING.md) pro podrobné pokyny - Viz [CONTRIBUTING.md](./CONTRIBUTING.md) pro podrobné pokyny
- V případě potřeby odkazujte čísla issue v popisu PR - Uveďte čísla issue v popisu PR, pokud je to relevantní
### Proces revize ### Proces revize
- PR kontrolují správci a komunita - PR jsou kontrolovány správci a komunitou
- Prioritou je vzdělávací srozumitelnost - Prioritní je srozumitelnost pro vzdělávání
- Příklady kódu by měly odpovídat aktuálním nejlepším praktikám - Příklady kódu by měly odpovídat aktuálním osvědčeným postupům
- Překlady se kontrolují z hlediska přesnosti a kulturní vhodnosti - Překlady jsou pečlivě revidovány pro přesnost a kulturní vhodnost
## Překladový systém ## Překladový systém
### Automatizovaný překlad ### Automatický překlad
- Používá GitHub Actions s workflow co-op-translator - Používá GitHub Actions s workflow co-op-translator
- Automaticky překládá do více než 50 jazyků - Automaticky překládá do více než 50 jazyků
- Zdrojové soubory v hlavních adresářích - Zdrojové soubory v hlavních adresářích
- Přeložené soubory v adresářích `translations/{jazykový-kód}/` - Přeložené soubory ve složkách `translations/{language-code}/`
### Přidávání manuálních úprav překladů ### Přidání manuálních vylepšení překladu
1. Najděte soubor v `translations/{jazykový-kód}/` 1. Najděte soubor ve složce `translations/{language-code}/`
2. Proveďte úpravy s zachováním struktury 2. Proveďte vylepšení se zachováním struktury
3. Ověřte, že příklady kódu zůstávají funkční 3. Ujistěte se, že příklady kódu zůstávají funkční
4. Testujte lokalizovaný obsah kvízů 4. Otestujte lokalizovaný obsah kvízů
### Metadata překladu ### Metadata překladu
Přeložené soubory obsahují hlavičku metadat: Přeložené soubory obsahují hlavičku s metadaty:
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -295,50 +295,50 @@ CO_OP_TRANSLATOR_METADATA:
**Quiz app se nespustí**: **Quiz app se nespustí**:
- Zkontrolujte verzi Node.js (doporučeno v14+) - Zkontrolujte verzi Node.js (doporučeno v14+)
- Smažte `node_modules` a `package-lock.json`, spusťte znovu `npm install` - Odstraňte `node_modules` a `package-lock.json`, spusťte `npm install` znovu
- Zkontrolujte konflikty portů (výchozí: Vite používá port 5173) - Zkontrolujte konflikt portů (výchozí: Vite používá port 5173)
**API server se nespustí**: **API server se nespustí**:
- Ověřte, že verze Node.js splňuje minimální požadavky (node >=10) - Ověřte minimální verzi Node.js (node >=10)
- Zkontrolujte, zda port není již obsazen - Zkontrolujte, zda port není již obsazen
- Ujistěte se, že jsou nainstalovány všechny závislosti `npm install` - Ujistěte se, že jsou nainstalovány všechny závislosti pomocí `npm install`
**Rozšíření prohlížeče se nenačte**: **Rozšíření prohlížeče se nenahraje**:
- Ověřte správné formátování manifest.json - Ověřte správné formátování manifest.json
- Zkontrolujte prohlížečovou konzoli na chyby - Zkontrolujte chyby v konzoli prohlížeče
- Postupujte podle návodů k instalaci rozšíření specifických pro prohlížeč - Postupujte podle pokynů instalace pro konkrétní prohlížeč
**Problémy s Python chat projektem**: **Problémy s Python chat projektem**:
- Ujistěte se, že balíček OpenAI je nainstalován: `pip install openai` - Ujistěte se, že balík OpenAI je nainstalovaný: `pip install openai`
- Ověřte nastavení proměnné prostředí GITHUB_TOKEN - Ověřte nastavení proměnné prostředí GITHUB_TOKEN
- Zkontrolujte oprávnění k přístupu k GitHub Models - Zkontrolujte přístupová práva k GitHub Models
**Docsify neposkytuje dokumentaci**: **Docsify neservíruje dokumentaci**:
- Nainstalujte docsify-cli globálně: `npm install -g docsify-cli` - Nainstalujte docsify-cli globálně: `npm install -g docsify-cli`
- Spusťte z kořenového adresáře repozitáře - Spusťte z kořenového adresáře repozitáře
- Ověřte existenci `docs/_sidebar.md` - Ujistěte se, že existuje soubor `docs/_sidebar.md`
### Tipy pro vývojové prostředí ### Tipy pro vývojové prostředí
- Používejte VS Code s rozšířením Live Server pro HTML projekty - Používejte VS Code s rozšířením Live Server pro HTML projekty
- Nainstalujte rozšíření ESLint a Prettier pro konzistentní formátování - Nainstalujte rozšíření ESLint a Prettier pro konzistentní formátování
- Použijte DevTools v prohlížeči pro debugování JavaScriptu - Používejte DevTools prohlížeče pro ladění JavaScriptu
- Pro Vue projekty nainstalujte Vue DevTools rozšíření do prohlížeče - Pro Vue projekty nainstalujte Vue DevTools rozšíření
### Výkonové aspekty ### Výkonnostní úvahy
- Velké množství překladových souborů (50+ jazyků) znamená velké klony - Velké množství přeložených souborů (50+ jazyků) znamená, že klony jsou velké
- Pro práci pouze s obsahem použijte shallow clone: `git clone --depth 1` - Použijte shallow clone, pokud pracujete pouze s obsahem: `git clone --depth 1`
- Při práci s anglickým obsahem vylučujte překlady z vyhledávání - Při práci na anglickém obsahu vynechejte překlady z vyhledávání
- První běh build procesů může být pomalý (npm install, Vite build) - Build procesy mohou být pomalejší při prvním spuštění (npm install, Vite build)
## Bezpečnostní aspekty ## Bezpečnostní opatření
### Proměnné prostředí ### Proměnné prostředí
- API klíče by se nikdy neměly commitovat do repozitáře - API klíče nikdy nezadávejte do repozitáře
- Používejte `.env` soubory (j v `.gitignore`) - Používejte `.env` soubory (jsou uvedeny v `.gitignore`)
- Dokumentujte požadované proměnné prostředí v README projektech - Dokumentujte požadované proměnné v README projektů
### Python projekty ### Python projekty
@ -348,61 +348,61 @@ CO_OP_TRANSLATOR_METADATA:
### Přístup k GitHub Models ### Přístup k GitHub Models
- Pro GitHub Models jsou potřeba Personal Access Tokens (PAT) - Osobní přístupové tokeny (PAT) jsou nutné pro GitHub Models
- Tokeny ukládejte jako proměnné prostředí - Tokeny by měly být uloženy jako proměnné prostředí
- Nikdy necommitujte tokeny či přihlašovací údaje - Nikdy neukládejte tokeny nebo přihlašovací údaje do repozitáře
## Další poznámky ## Další poznámky
### Cílová skupina ### Cílová skupina
- Úplní začátečníci ve webovém vývoji - Kompletní začátečníci ve webovém vývoji
- Studenti a samouci - Studenti a samouci
- Učitelé používající kurikulum ve třídách - Učitelé využívající kurikulum ve třídách
- Obsah je navržen pro přístupnost a postupné rozvíjení dovedností - Obsah je navržen pro přístupnost a postupné budování dovedností
### Vzdělávací filozofie ### Vzdělávací filozofie
- Přístup založený na projektech - Přístup založený na projektech
- Časté ověřování znalostí (kvízy) - Časté kontroly znalostí (kvízy)
- Praktická cvičení kódování - Praktická cvičení v kódování
- Příklady využití v reálném světě - Příklady z reálného světa
- Zaměření na základy před frameworky - Zaměření na základy před frameworky
### Údržba repozitáře ### Údržba repozitáře
- Aktivní komunita studentů a přispěvatelů - Aktivní komunita studentů a přispěvatelů
- Pravidelné aktualizace závislostí a obsahu - Pravidelné aktualizace závislostí a obsahu
- Sledují se issues a diskuse správci - Problémy a diskuze jsou monitorovány správci
- Aktualizace překladů automatizovány přes GitHub Actions - Aktualizace překladů jsou automatizovány přes GitHub Actions
### Související zdroje ### Související zdroje
- [Microsoft Learn moduly](https://docs.microsoft.com/learn/) - [Microsoft Learn moduly](https://docs.microsoft.com/learn/)
- [Student Hub zdroje](https://docs.microsoft.com/learn/student-hub/) - [Student Hub zdroje](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) doporučený pro studenty - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) doporučený pro studenty
- Další kurzy: Generativní AI, Data Science, ML, IoT kurikula dostupná - Další kurzy: Generative AI, Data Science, ML, IoT kurikula k dispozici
### 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: Pro podrobné instrukce k jednotlivým projektům viz README soubory v:
- `quiz-app/README.md` - Vue 3 kvízová aplikace - `quiz-app/README.md` - Vue 3 aplikace kvízu
- `7-bank-project/README.md` - Bankovní aplikace s autentifikací - `7-bank-project/README.md` - Bankovní aplikace s autentizací
- `5-browser-extension/README.md` - Vývoj rozšíření prohlížeče - `5-browser-extension/README.md` - Vývoj rozšíření prohlížeče
- `6-space-game/README.md` - Vývoj hry s využitím Canvas - `6-space-game/README.md` - Vývoj hry na canvasu
- `9-chat-project/README.md` - Projekt AI chat asistenta - `9-chat-project/README.md` - Projekt AI chat asistenta
### Struktura monorepa ### Struktura monorepa
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á - Každá lekce je samostatná
- Projekty nesdílí závislosti - Projekty nesdílejí závislosti
- Pracujte na jednotlivých projektech, aniž byste ovlivnili ostatní - Pracujte na jednotlivých projektech bez ovlivnění ostatních
- Pro plný kurz si naklonujte celý repozitář - Pro plný zážitek klonujte celý repozitář kurikula
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Vyloučení odpovědnosti**: **Prohlášení o vyloučení odpovědnosti**:
Tento dokument byl přeložen pomocí služby automatického překladu [Co-op Translator](https://github.com/Azure/co-op-translator). I když 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 původním jazyce by měl být považován za závazný zdroj. Pro důležité informace doporučujeme profesionální lidský překlad. Nejsme odpovědni za jakékoliv nedorozumění či nesprávné výklady vyplývající z použití tohoto překladu. Tento dokument byl přeložen pomocí AI překladatelské služby [Co-op Translator](https://github.com/Azure/co-op-translator). I když usilujeme o přesnost, mějte prosím na paměti, že automatizované 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 je doporučen profesionální lidský překlad. Nejsme odpovědní za jakákoliv nedorozumění nebo chybné interpretace vyplývající z použití tohoto překladu.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -1,7 +1,7 @@
{ {
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": { "1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8", "original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-06T15:55:42+00:00", "translation_date": "2026-03-27T19:38:33+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md", "source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "hu" "language_code": "hu"
}, },
@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T16:05:29+00:00", "translation_date": "2026-03-27T19:44:46+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "hu" "language_code": "hu"
}, },

@ -2,29 +2,29 @@
## Projekt áttekintése ## Projekt áttekintése
Ez egy oktatási tanterv-tár, amely a kezdők számára tanítja a webfejlesztés alapjait. A tanterv egy átfogó, 12 hetes kurzus, amelyet a Microsoft Cloud Advocates fejlesztett ki, 24 gyakorlati órával, amelyek JavaScript-et, CSS-t és HTML-t fednek le. Ez egy oktatási tananyag-tár, amely a webfejlesztés alapjainak tanítására szolgál kezdők számára. A tananyag egy átfogó, 12 hetes kurzus, amelyet a Microsoft Cloud Advocates fejlesztett ki, és 24 gyakorlati leckét tartalmaz, amelyek JavaScript-et, CSS-t és HTML-t fednek le.
### Fő komponensek ### Főbb elemek
- **Oktatási tartalom**: 24 strukturált lecke projekt-alapú modulokban szervezve - **Oktatási tartalom**: 24 strukturált lecke, projekt-alapú modulokba rendezve
- **Gyakorlati projektek**: Terrárium, Gépelő játék, Böngészőbővítmény, Űrjáték, Banki alkalmazás, Kódszerkesztő és AI chat asszisztens - **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 csevegőasszisztens
- **Interaktív kvízek**: 48 kvíz, mindegyik 3 kérdéssel (elő- és utóleckés felmérések) - **Interaktív kvízek**: 48 kvíz, mindegyik 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 - **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) - **Technológiák**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI projektekhez)
### Architektúra ### Architektúra
- Oktatási tár tanulási egységek szerint felépítve - Oktatási tárhely lecke-alapú struktúrával
- Minden lecke mappája README-t, kódpéldákat és megoldásokat tartalmaz - 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önféle lecke projektek) - Önálló projektek külön könyvtárakban (quiz-app, különböző lecke projektek)
- Fordító rendszer GitHub Actions használatával (co-op-translator) - Fordítási rendszer GitHub Actions (co-op-translator) használatával
- Dokumentáció Docsify-val szolgáltatva, PDF formátumban is elérhető - Dokumentáció Docsify-val szolgáltatva és PDF-ben elérhető
## Beállítási parancsok ## Telepítési parancsok
Ez a tároló elsősorban az oktatási tartalmak fogyasztására szolgál. Egyes projektekhez való munkához: Ez a tárhely elsősorban oktatási tartalom fogyasztására szolgál. Egyedi projektekkel való munka esetén:
### Fő tár beállítása ### Fő tárhely beállítása
```bash ```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
@ -37,7 +37,7 @@ cd Web-Dev-For-Beginners
cd quiz-app cd quiz-app
npm install npm install
npm run dev # Fejlesztői szerver indítása npm run dev # Fejlesztői szerver indítása
npm run build # Építés éles környezetre npm run build # Termelésre építés
npm run lint # ESLint futtatása npm run lint # ESLint futtatása
``` ```
@ -48,7 +48,7 @@ cd 7-bank-project/api
npm install npm install
npm start # Indítsa el az API szervert npm start # Indítsa el az API szervert
npm run lint # Futtassa az ESLint-et npm run lint # Futtassa az ESLint-et
npm run format # Formázza Prettier-rel npm run format # Formázás Prettier-rel
``` ```
### Böngészőbővítmény projektek ### Böngészőbővítmény projektek
@ -56,7 +56,7 @@ npm run format # Formázza Prettier-rel
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
npm install 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
``` ```
### Űrjáték projektek ### Űrjáték projektek
@ -64,10 +64,10 @@ npm install
```bash ```bash
cd 6-space-game/solution cd 6-space-game/solution
npm install npm install
# Nyisd meg az index.html fájlt a böngészőben vagy használd a Live Server-t # Nyisd meg az index.html-t böngészőben vagy használd a Live Server-t
``` ```
### Chat projekt (Python backend) ### Csevegő projekt (Python háttér)
```bash ```bash
cd 9-chat-project/solution/backend/python cd 9-chat-project/solution/backend/python
@ -78,31 +78,31 @@ python api.py
## Fejlesztési munkafolyamat ## Fejlesztési munkafolyamat
### Tartalomközreműködőknek ### Tartalomszolgáltatók számára
1. **Forkold a tárat** a GitHub fiókodba 1. **Forkold a tárhelyet** a saját GitHub fiókodba
2. **Klónozd le a forkodat** helyileg 2. **Klónozd le** a forkot helyileg
3. **Hozz létre egy új ágat** a változtatásaidhoz 3. **Hozz létre egy új ágat** a változtatásaid számára
4. Végezze el a módosításokat a leckék tartalmán vagy kód példákon 4. Módosítsd a lecke tartalmát vagy a kódpéldákat
5. Tesztelje a kódváltozásokat az érintett projekt mappákban 5. Teszteld a kódváltoztatásokat a vonatkozó projekt könyvtáraiban
6. Küldj be pull requesteket a hozzájárulási irányelvek szerint 6. Küldj pull requesteket a hozzájárulási útmutató szerint
### Tanulóknak ### Tanulók számára
1. Forkold vagy klónozd le a tárat 1. Forkold vagy klónozd a tárhelyet
2. Folytasd a leckék mappáiban egymás után 2. Lépj sorban a lecke könyvtárakba
3. Olvasd el az egyes leckék README fájljait 3. Olvasd el az egyes leckék README fájljait
4. Teljesítsd az elő-lecke kvízeket a https://ff-quizzes.netlify.app/web/ címen 4. Teljesítsd az előleckés kvízeket a https://ff-quizzes.netlify.app/web/ oldalon
5. Dolgozz át a leckék mappa kód példáin 5. Dolgozz át a lecke mappák kódpéldáin
6. Fejezd be a feladatokat és kihívásokat 6. Végezd el a feladatokat és kihívásokat
7. Csakazután végezd el az utó-lecke kvízeket 7. Teljesítsd a utóleckés kvízeket
### Élő fejlesztés ### Élő fejlesztés
- **Dokumentáció**: Futtasd a `docsify serve` parancsot a gyökérben (3000-es porton) - **Dokumentáció**: Futtasd a `docsify serve` parancsot a gyökérkönyvtárban (3000-es porton)
- **Kvíz alkalmazás**: `npm run dev` a quiz-app mappában - **Kvíz alkalmazás**: Futtasd az `npm run dev` parancsot a quiz-app könyvtárban
- **Projektek**: Használd a VS Code Live Server kiterjesztését HTML projektekhez - **Projektek**: Használd a VS Code Live Server kiterjesztését HTML projektekhez
- **API projektek**: Futtasd az `npm start` parancsot a megfelelő API mappákban - **API projektek**: Futtasd az `npm start` parancsot a megfelelő API könyvtárakban
## Tesztelési utasítások ## Tesztelési utasítások
@ -119,164 +119,164 @@ npm run build # Ellenőrizze, hogy a build sikeres-e
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm run lint # Ellenőrizze a kódstílus problémákat npm run lint # Ellenőrizze a kódstílus problémákat
node server.js # Ellenőrizze, hogy a szerver hibák nélkül indul-e node server.js # Ellenőrizze, hogy a szerver hibamentesen indul-e
``` ```
### Általános tesztelési megközelítés ### Általános tesztelési megközelítés
- Ez egy oktatási tár, nincs teljes körű automatizált tesztelés - Ez egy oktatási tárhely, átfogó automatikus tesztek nélkül
- Manuális tesztek fókuszpontjai: - Manuális tesztelés fókuszpontjai:
- Kódpéldák hibamentesen futnak - Kódpéldák hibamentes futása
- Dokumentációban lévő linkek helyesek - Dokumentáció linkjeinek helyessége
- Projektek sikeresen épülnek - Projektek sikeres buildelése
- Példák követik a legjobb gyakorlatokat - Példák legjobb gyakorlatokat követnek
### Előzetes ellenőrzések benyújtás előtt ### Beküldés előtti ellenőrzések
- Futtasd az `npm run lint` parancsot azokban a mappákban, ahol van package.json - Futtasd az `npm run lint` parancsot a package.json fájlt tartalmazó könyvtárakban
- Ellenőrizd a markdown linkek érvényes működését - Ellenőrizd a markdown linkeket
- Teszteld a kódpéldákat böngészőben vagy Node.js-ben - Teszteld a kódpéldákat böngészőben vagy Node.js-ben
- Ellenőrizd, hogy a fordítások megfelelő szerkezetet tartanak meg - Ellenőrizd, hogy a fordítások megfelelő szerkezetet tartanak fenn
## Kódszabvány irányelvek ## Kódstílus irányelvek
### JavaScript ### JavaScript
- Használj modern ES6+ szintaxist - Használj modern ES6+ szintaxist
- Kövesd a projektekben megadott szabványos ESLint beállításokat - Kövesd a projektekben megadott szabványos ESLint konfigurációkat
- Használj értelmes változó- és függvénynév adás a tanulók érthetőségéért - Használj érthető változó- és függvényneveket az oktatási érthetőségért
- Tegyél bele magyarázó kommenteket a fogalmak elmagyarázásához - Adj hozzá kommenteket a fogalmak magyarázatához tanulók számára
- Formázd Prettier-rel, ahol be van állítva - Formázd a kódot Prettier-rel, ahol be van állítva
### HTML/CSS ### HTML/CSS
- Szemiantikus HTML5 elemek használata - Szemantikus HTML5 elemek
- Reszponzív tervezési alapelvek - Reszponzív tervezési elvek
- Egyértelmű osztálynév konvenciók - Áttekinthető osztályelnevezések
- Kommentek CSS technikák elmagyarázásához a tanulók számára - Kommentekkel magyarázott CSS technikák tanulóknak
### Python ### Python
- PEP 8 stílusirányelvek követése - PEP 8 stílus előírások
- Világos, oktató jellegű kódpéldák - Tiszta, oktató jellegű kódpéldák
- Típusjavaslatok, ahol segítik a tanulást - Típusjelzések, ha hasznos a tanuláshoz
### Markdown dokumentáció ### Markdown dokumentáció
- Átlátható címsor hierarchia - Világos címsor struktúra
- Kódrészek nyelvi specifikációval - Kódblokkok nyelvi megjelöléssel
- Hivatkozások további forrásokra - Hivatkozások további forrásokra
- Képernyőképek és képek az `images/` könyvtárakban - Képernyőképek és képek az `images/` könyvtárakban
- Képekhez alt szöveg az akadálymentességért - Alternatív szöveg a képekhez hozzáférhetőség miatt
### Fájl szervezés ### Fájlok szervezése
- A leckék sorszámozott sorrendben (1-getting-started-lessons, 2-js-basics stb.) - A leckék folyamatos számozással (1-getting-started-lessons, 2-js-basics stb.)
- Minden projekthez tartozik `solution/` és gyakran `start/` vagy `your-work/` mappa - Minden projektnek van `solution/`, gyakran `start/` vagy `your-work/` könyvtára
- Képek a lecke-specifikus `images/` könyvtárakban tárolva - Képek lecke-specifikus `images/` mappákban tárolva
- Fordítások a `translations/{language-code}/` struktúrában - Fordítások a `translations/{language-code}/` struktúrában
## Build és telepítés ## Build és telepítés
### Kvíz alkalmazás telepítése (Azure Static Web Apps) ### Kvíz alkalmazás telepítése (Azure Static Web Apps)
A quiz-app konfigurálva van Azure Static Web Apps telepítésre: A quiz-app konfigurálva van Azure Static Web Apps telepítéshez:
```bash ```bash
cd quiz-app cd quiz-app
npm run build # Létrehozza a dist/ mappát npm run build # Létrehozza a dist/ mappát
# GitHub Actions munkafolyamattal telepít nyomásra a main ágban # GitHub Actions munkafolyamat segítségével telepít a main ágra történő push esetén
``` ```
Azure Static Web Apps beállítás: Azure Static Web Apps konfiguráció:
- **Alkalmazás helye**: `/quiz-app` - **App helye**: `/quiz-app`
- **Kimeneti hely**: `dist` - **Kimeneti hely**: `dist`
- **Folyamat**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Dokumentáció PDF generálás ### Dokumentáció PDF generálás
```bash ```bash
npm install # docsify-to-pdf telepítése npm install # Telepítse a docsify-to-pdf csomagot
npm run convert # PDF generálása dokumentumokból npm run convert # PDF generálása dokumentációból
``` ```
### Docsify dokumentáció ### Docsify dokumentáció
```bash ```bash
npm install -g docsify-cli # Telepítse a Docsify-t globálisan npm install -g docsify-cli # Docsify telepítése globálisan
docsify serve # Szolgáltatás localhost:3000 címen docsify serve # Szolgáltatás futtatása a localhost:3000 címen
``` ```
### Projekt-specifikus build folyamatok ### Projekt-specifikus build folyamatok
Minden projekthez lehet saját build folyamat: Minden projekt könyvtárában lehet saját build lépés:
- Vue projektek: `npm run build` előállítja a gyártásra kész csomagokat - Vue projektek: az `npm run build` elkészíti a gyártási csomagokat
- Statikus projektek: nincs build lépés, fájlokat közvetlenül szolgáltatja - Statikus projektek: nincs külön build lépés, a fájlokat közvetlen szolgálja ki
## Pull request irányelvek ## Pull request irányelvek
### Cím formátuma ### Címsor formátum
Használj világos, leíró címeket, amelyek jelzik a változtatás területét: Használj tiszta, leíró címsorokat, amelyek jelzik a változtatás területét:
- `[Quiz-app] Új kvíz a X. leckéhez` - `[Quiz-app] Új kvíz hozzáadása az X. leckéhez`
- `[Lesson-3] Elírás javítása a terrárium projektnél` - `[Lesson-3] Elírás javítása a terrárium projektben`
- `[Translation] Spanyol fordítás hozzáadása az 5. leckéhez` - `[Translation] Spanyol fordítás hozzáadása az 5. leckéhez`
- `[Docs] Beállítási útmutató frissítése` - `[Docs] Telepítési utasítások frissítése`
### Kötelező ellenőrzések ### Kötelező ellenőrzések
Pull request beküldése előtt: PR beküldése előtt:
1. **Kódminőség**: 1. **Kódminőség**:
- Futtasd az `npm run lint` parancsot a változtatott projektekben - Futás `npm run lint` a érintett projekt könyvtáraiban
- Javítsd a minden lint figyelmeztetést és hibát - Javíts minden lint hibát és figyelmeztetést
2. **Build ellenőrzés**: 2. **Build ellenőrzés**:
- Futtasd az `npm run build`-et, ha van ilyen lépés - Futtasd az `npm run build` parancsot, ha van ilyen lépés
- Győződj meg, hogy nincs build hiba - Győződj meg, hogy nincs build hiba
3. **Linkellenőrzés**: 3. **Hivatkozások ellenőrzése**:
- Teszteld az összes markdown linket - Teszteld a markdown linkeket
- Ellenőrizd a képek hivatkozásának működését - Ellenőrizd a kép hivatkozásokat
4. **Tartalom átvizsgálás**: 4. **Tartalom átnézése**:
- Ellenőrizd a helyesírást és nyelvtant - Ellenőrizd helyesírást és nyelvtant
- Győződj meg a kódpéldák helyességéről és oktató jellegről - Győződj meg a kódpéldák helyességéről és oktatási jellegéről
- Vizsgáld a fordítások pontosságát és eredeti jelentéstartalmat - Ellenőrizd, hogy a fordítások megőrzik az eredeti jelentést
### 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) - Fogadj el Microsoft CLA-t (automatikus ellenőrzés az első PR-nál)
- Kövesd a [Microsoft Open Source Etikai Kódexét](https://opensource.microsoft.com/codeofconduct/) - Kövesd a [Microsoft nyílt forráskódú magatartási kódexét](https://opensource.microsoft.com/codeofconduct/)
- Részletes szabályok a [CONTRIBUTING.md](./CONTRIBUTING.md) fájlban - Részletes útmutatók a [CONTRIBUTING.md](./CONTRIBUTING.md) fájlban
- PR leírásában hivatkozz issue számokra, ha releváns - Ha van, hivatkozz issue számokra a PR leírásában
### Átvizsgálási folyamat ### Áttekintési folyamat
- PR-eket a karbantartók és a közösség bírálja el - A PR-eket a karbantartók és a közösség vizsgálja át
- Oktatási világosság előnyben - Oktatási érthetőség az elsődleges szempont
- Kódpéldák kövessék a jelenlegi legjobb gyakorlatokat - Kódpéldák kövessék a legjobb aktuális gyakorlatokat
- Fordításokat ellenőrzik pontosság és kulturális illeszkedés szempontjából - A fordításokat pontosság és kulturális megfelelőség alapján értékelik
## Fordítási rendszer ## Fordítási rendszer
### Automatikus fordítás ### Automatikus fordítás
- GitHub Actions használata co-op-translator munkafolyamattal - GitHub Actions használatával, co-op-translator workflow-val
- Automatikusan fordít 50+ nyelvre - 50+ nyelvre automatikusan fordít
- Forrásfájlok a fő könyvtárakban - Forrásfájlok a fő könyvtárakban
- Fordított fájlok a `translations/{language-code}/` mappákban - Fordított fájlok a `translations/{language-code}/` mappákban
### Kézi fordítási javítások hozzáadása ### Kézi fordítási javítások hozzáadása
1. Keresd meg a fájlt a `translations/{language-code}/` könyvtárban 1. Keresd meg a fájlt a `translations/{language-code}/` könyvtárban
2. Végezze el a javításokat, miközben megőrzi a szerkezetet 2. Javításokat végezz a szerkezet megtartásával
3. Gondoskodj arról, hogy a kódpéldák továbbra is működjenek 3. Biztosítsd, hogy a kódpéldák továbbra is működnek
4. Teszteld az esetleges lokalizált kvíz tartalmakat 4. Teszteld a lokalizált kvíz tartalmakat
### Fordítási metaadatok ### Fordítás metaadatok
A fordított fájlok tartalmazzák a metaadat fejlécet: A fordított fájlok tartalmazzák az alábbi metaadat fejléceket:
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
--> -->
``` ```
## Hibakeresés és hibaelhárítás ## Hibakeresés és problémamegoldás
### Gyakori problémák ### Gyakori problémák
**A kvíz alkalmazás nem indul el**: **Kvíz alkalmazás nem indul**:
- Ellenőrizd a Node.js verziót (javasolt v14+) - Ellenőrizd a Node.js verziót (v14+ ajánlott)
- Töröld a `node_modules` és a `package-lock.json` fájlokat, majd futtasd újra az `npm install` parancsot - Töröld a `node_modules` és a `package-lock.json` fájlokat, majd futtasd újra az `npm install` parancsot
- Ellenőrizd, hogy nincs portütközés (alapértelmezés szerint: Vite a 5173-as portot használja) - Ellenőrizd a port ütközéseket (alapértelmezett: Vite 5173-as portot használ)
**API szerver nem indul**: **API szerver nem indul**:
- Ellenőrizd, hogy a Node.js verzió legalább 10-es - Ellenőrizd, hogy a Node.js verzió megfelel-e a minimum követelménynek (node >=10)
- Ellenőrizd, hogy a port szabad-e - Ellenőrizd, hogy a port nincs-e már használatban
- Győződj meg róla, hogy minden függőség telepítve van az `npm install`-lal - Győződj meg róla, hogy minden függőség telepítve van az `npm install` futtatásával
**Böngészőbővítmény nem töltődik be**: **Böngészőbővítmény nem töltődik be**:
- Ellenőrizd, hogy a manifest.json helyesen van-e formázva - Ellenőrizd, hogy a manifest.json megfelelő formátumú
- Nézd meg a böngésző konzolját hibákért - 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 útmutatóját - Kövesd a böngésző-specifikus bővítmény telepítési utasokat
**Python chat projekt problémák**: **Python chat projekt problémák**:
- Biztosítsd, hogy az OpenAI csomag telepítve legyen: `pip install openai` - 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, hogy a GITHUB_TOKEN környezeti változó be van-e állítva
- Nézd meg a GitHub Models hozzáférési jogosultságokat - Vizsgáld meg a GitHub Models hozzáférési jogosultságokat
**Docsify nem szolgáltat dokumentációt**: **Docsify nem szolgáltat dokumentációt**:
- Telepítsd globálisan: `npm install -g docsify-cli` - Telepítsd globálisan a docsify-cli-t: `npm install -g docsify-cli`
- Futtasd a tár gyökérkönyvtárából - Futtasd a parancsot a tárhely gyökeréből
- Ellenőrizd, hogy létezik a `docs/_sidebar.md` fájl - Ellenőrizd, hogy létezik a `docs/_sidebar.md` fájl
### Fejlesztési környezet tippek ### Fejlesztési környezet tippek
- Használd VS Code-ot Live Server kiterjesztéssel HTML projektekhez - Használj VS Code-ot Live Server kiterjesztéssel HTML projektekhez
- Telepítsd az ESLint és Prettier kiterjesztéseket az egységes formázáshoz - Telepítsd az ESLint és Prettier bővítményeket az egységes formázáshoz
- Használd a böngésző fejlesztői eszközeit JavaScript hibakereséshez - Használd a böngésző fejlesztői eszközeit JavaScript hibakereséshez
- Vue projektekhez telepítsd a Vue DevTools böngésző kiegészítőt - Vue projektekhez telepítsd a Vue DevTools böngésző kiterjesztést
### Teljesítmény szempontok ### Teljesítményre vonatkozó megfontolások
- Nagyszámú fordított fájl (50+ nyelv) miatt a teljes klón nagy méretű - A több mint 50 nyelvű fordítás miatt a teljes klónozás nagy méretű lehet
- Használj sekély klónt, ha csak a tartalmakon dolgozol: `git clone --depth 1` - Használj sekély klónozást, ha csak a tartalmon dolgozol: `git clone --depth 1`
- Fordításokat zárd ki a keresésből, ha angol tartalmakon dolgozol - A kereséseknél kizárhatod a fordításokat, ha csak angol tartalmon dolgozol
- A build folyamatok lassúak lehetnek első futtatáskor (npm install, Vite build) - Az első futtatásnál (npm install, Vite build) lassúak lehetnek a build folyamatok
## Biztonsági megfontolások ## Biztonsági megfontolások
### Környezeti változók ### Környezeti változók
- API kulcsokat soha ne tárolj a tárban - Az API kulcsokat soha ne köteleződjenek el a tárhelyen
- Használj `.env` fájlokat (ezek már benne vannak a `.gitignore`-ban) - Használj `.env` fájlokat (amelyek már benne vannak a `.gitignore`-ban)
- Dokumentáld a szükséges környezeti változókat a projektek README-jeiben - Dokumentáld a szükséges környezeti változókat a projekt README fájljaiban
### Python projektek ### Python projektek
- Használj virtuális környezeteket: `python -m venv venv` - Használj virtuális környezeteket: `python -m venv venv`
- Tartsd naprakészen a függőségeket - Tartsd naprakészen a függőségeket
- GitHub tokenek csak minimálisan szükséges jogosultságokkal legyenek beállítva - A GitHub tokenek rendelkezzenek csak a szükséges minimális jogosultságokkal
### GitHub Models hozzáférés ### GitHub Models hozzáférés
- Személyes hozzáférési tokenek (PAT) szükségesek GitHub Models használatához - Személyes hozzáférési token (PAT) szükséges a GitHub Models használatához
- Tokeneket környezeti változóként tárold - A tokeneket környezeti változóként tárold
- Soha ne tárold vagy commitáld a tokeneket vagy hitelesítő adatokat - Soha ne köteleződj el tokeneket vagy hitelesítő adatokat
## További megjegyzések ## Egyéb megjegyzések
### Célközönség ### Célközönség
- Teljesen kezdő webfejlesztők - Teljesen kezdő webfejlesztők
- Diákok és önálló tanulók - Tanulók és önálló tanulók
- Tanárok, akik ezt a tantervet használják osztálytermekben - Tanárok, akik az oktatási tananyagot osztálytermi használatra alkalmazzák
- A tartalom akadálymentes és fokozatos készségfejlesztést szolgál - A tartalom hozzáférhető és fokozatos képességfejlesztést biztosít
### Oktatási filozófia ### Oktatási filozófia
- Projekt-alapú tanulás - Projektalapú tanulás
- Gyakori tudásellenőrzések (kvízek) - Gyakori tudásellenőrző kvízek
- Gyakorlati kódolási feladatok - Gyakorlati kódolási feladatok
- Valós példák alkalmazásra - Valós világban használható példák
- Alapok elsajátítása keretrendszerek előtt - Alapokra fókuszálás a keretrendszerek előtt
### Tároló karbantartása ### Tárhely karbantartása
- Aktív tanulói és közreműködői közösség - Aktív tanulói és közreműködő közösség
- Függőségek és tartalom rendszeres frissítése - Rendszeres frissítések a függőségekhez és tartalomhoz
- Hibák és viták karbantartói felügyelete - Issue-k és beszélgetések karbantartói felügyelete
- Fordítások automatikus frissítése GitHub Actions által - Fordítások automatikusan frissülnek GitHub Actions segítségével
### Kapcsolódó források ### Kapcsolódó források
- [Microsoft Learn modulok](https://docs.microsoft.com/learn/) - [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 - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) ajánlott a tanulóknak
- Kiegészítő kurzusok: Generatív AI, Adattudomány, ML, IoT tantervek elérhetőek - További kurzusok: Generatív AI, Data Science, ML, IoT tananyagok elérhetők
### Egyedi projektek kezelése ### Egyedi projektek kezelése
Részletes útmutatás egyes projektekhez a README fájlokban: Egyéni projektek részletes útmutatói elérhetők a README fájlokban:
- `quiz-app/README.md` - Vue 3-alapú kvíz alkalmazás - `quiz-app/README.md` - Vue 3 kvíz alkalmazás
- `7-bank-project/README.md` - Banki alkalmazás hitelesítéssel - `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 - `5-browser-extension/README.md` - Böngészőbővítmény fejlesztés
- `6-space-game/README.md` - Canvas alapú játékfejlesztés - `6-space-game/README.md` - Canvas alapú játék fejlesztés
- `9-chat-project/README.md` - AI chat asszisztens projekt - `9-chat-project/README.md` - AI csevegő asszisztens projekt
### Monorepo szerkezet ### Monorepo struktúra
Bár nem hagyományos monorepo, ez a tár több független projektet tartalmaz: Bár nem hagyományos monorepóról van szó, ez a tárhely több független projektet tartalmaz:
- Minden lecke önálló - Minden lecke önálló egység
- Projektek nem osztoznak függőségeken - A projektek nem osztanak meg függőségeket
- Egyedi projekteken dolgozhatsz anélkül, hogy a többit érintenéd - Egyedi projekteken dolgozhatsz anélkül, hogy másokat befolyásolnál
- A teljes tantervi élményhez klónozd az egész tárat - Teljes tananyag élményéhez klónozd az egész tárhelyet
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Felelősségkizárás**: **Felelősségkizárás**:
Ezt a dokumentumot a [Co-op Translator](https://github.com/Azure/co-op-translator) mesterséges intelligencia fordító szolgáltatás segítségével fordítottuk le. Bár az pontosságra törekszünk, kérjük, vegye figyelembe, hogy az automatikus fordítások hibákat vagy pontatlanságokat tartalmazhatnak. Az eredeti dokumentum az anyanyelvé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 a fordításból eredő félreértésekért vagy félreértelmezésekért. Ez a dokumentum az [Co-op Translator](https://github.com/Azure/co-op-translator) AI fordító szolgáltatás segítségével készült. Bár a pontosságra törekszünk, kérjük, vegye figyelembe, hogy az automatikus fordítások hibákat vagy pontatlanságokat tartalmazhatnak. Az eredeti dokumentum az anyanyelvén tekintendő hivatalos forrásnak. Kritikus információk esetén professzionális emberi fordítást javasolt igénybe venni. Nem vállalunk felelősséget semmilyen félreértésért vagy helytelen értelmezésért, amely ebből a fordításból adódik.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -1,7 +1,7 @@
{ {
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": { "1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8", "original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-06T15:47:51+00:00", "translation_date": "2026-03-27T19:33:46+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md", "source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "sw" "language_code": "sw"
}, },
@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T16:03:56+00:00", "translation_date": "2026-03-27T19:43:29+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "sw" "language_code": "sw"
}, },

@ -2,53 +2,53 @@
## Muhtasari wa Mradi ## Muhtasari wa Mradi
Hii ni hifadhidata ya mtaala wa kielimu kwa kufundisha misingi ya maendeleo ya wavuti kwa wanaoanza. Mtaala huu ni kozi kamili ya wiki 12 iliyotengenezwa na Wakili wa Microsoft Cloud, ikiwa na masomo 24 ya vitendo yanayohusisha JavaScript, CSS, na HTML. Huu ni hazina ya mtaala wa elimu kwa kufundisha misingi ya maendeleo ya wavuti kwa wanaoanza. Mtaala huu ni kozi kamili ya wiki 12 iliyotengenezwa na Wataalamu wa Microsoft Cloud, ikijumuisha masomo 24 ya vitendo kuhusu JavaScript, CSS, na HTML.
### Sehemu Muhimu ### Vipengele Vikuu
- **Maudhui ya Kielimu**: Masomo 24 yaliyopangwa katika moduli za miradi - **Maudhui ya Elimu**: Masomo 24 yaliyopangwa katika moduli za mradi
- **Miradi ya Vitendo**: Terrarium, Mchezo wa Kutaipa, Kiongezi cha Kivinjari, Mchezo wa Anga, Programu ya Benki, Mhariri wa Msimbo, na Msaidizi wa Mazungumzo wa AI - **Miradi ya Vitendo**: Terrarium, Mchezo wa Kuandika, Kiongezi cha Kivinjari, Mchezo wa Anga, Programu ya Benki, Mhariri wa Msimbo, na Msaidizi wa Mazungumzo wa AI
- **Mitozo ya Kuingiliana**: Mitozo 48 yenye maswali 3 kila mmoja (vipimo kabla/baada ya somo) - **Mtihani wa Kuingiliana**: Maswali 48 yenye maswali 3 kila mmoja (vipimo kabla/baada ya somo)
- **Msaada wa Lugha Nyingi**: Tafsiri za kiotomatiki kwa lugha 50+ kupitia GitHub Actions - **Msaada wa Lugha Nyingi**: Tafsiri za moja kwa moja kwa lugha 50+ kupitia GitHub Actions
- **Teknolojia**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (kwa miradi ya AI) - **Teknolojia**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (kwa miradi ya AI)
### Miundo ### Miamala
- Hifadhidata ya kielimu yenye muundo wa masomo - Hazina ya elimu yenye muundo wa masomo
- Kila folda ya somo ina README, mifano ya msimbo, na suluhisho - Kila folda ya somo ina README, mifano ya msimbo, na suluhisho
- Miradi huru katika folda tofauti (quiz-app, miradi mbalimbali ya masomo) - Miradi huru katika folda tofauti (quiz-app, miradi mbalimbali ya somo)
- Mfumo wa tafsiri ukitumia GitHub Actions (co-op-translator) - Mfumo wa tafsiri kutumia GitHub Actions (co-op-translator)
- Hati hutolewa kupitia Docsify na zinapatikana pia kama PDF - Nyaraka zinatolewa kupitia Docsify na zinapatikana kama PDF
## Amri za Kuanzisha ## Amri za Usanidi
Hifadhidata hii ni kwa ajili ya matumizi ya maudhui ya kielimu hasa. Kwa kufanya kazi na miradi maalum: Hazina hii ni kwa ajili ya matumizi ya maudhui ya elimu pekee. Kwa kazi na miradi maalum:
### Kuanzisha Hifadhidata Kuu ### Usanidi wa Hazina Kuu
```bash ```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners cd Web-Dev-For-Beginners
``` ```
### Kuanzisha App ya Mitozo (Vue 3 + Vite) ### Usanidi wa Quiz App (Vue 3 + Vite)
```bash ```bash
cd quiz-app cd quiz-app
npm install npm install
npm run dev # Anzisha seva ya maendeleo npm run dev # Anzisha server ya maendeleo
npm run build # Tengeneza kwa ajili ya uzalishaji npm run build # Tengeneza kwa ajili ya uzalishaji
npm run lint # Endesha ESLint npm run lint # Endesha ESLint
``` ```
### API ya Mradi wa Benki (Node.js + Express) ### Mradi wa API ya Benki (Node.js + Express)
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm install npm install
npm start # Anza seva ya API npm start # Anzisha seva ya API
npm run lint # Endesha ESLint npm run lint # Endesha ESLint
npm run format # Panga na Prettier npm run format # Panga kwa Prettier
``` ```
### Miradi ya Kiongezi cha Kivinjari ### Miradi ya Kiongezi cha Kivinjari
@ -56,7 +56,7 @@ npm run format # Panga na Prettier
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
npm install npm install
# Fuata maelekezo ya kupakia viendelezi maalum kwa kivinjari # Fuata maelekezo ya upakiaji ya nyongeza za kivinjari maalum
``` ```
### Miradi ya Mchezo wa Anga ### Miradi ya Mchezo wa Anga
@ -64,7 +64,7 @@ npm install
```bash ```bash
cd 6-space-game/solution cd 6-space-game/solution
npm install npm install
# Fungua index.html kwenye kivinjari au tumia Live Server # Fungua index.html katika kivinjari au tumia Live Server
``` ```
### Mradi wa Mazungumzo (Python Backend) ### Mradi wa Mazungumzo (Python Backend)
@ -76,124 +76,124 @@ pip install openai
python api.py python api.py
``` ```
## Mtiririko wa Maendeleo ## Mchakato wa Maendeleo
### Kwa Wachangia Maudhui ### Kwa Wachangiaji wa Maudhui
1. **Fungua hifadhidata** kwenye akaunti yako ya GitHub 1. **Fanya fork ya hazina** kwenye akaunti yako ya GitHub
2. **Nakili hifadhidata ya macho** kwa kompyuta yako 2. **Clone fork yako** kwa ndani
3. **Tengeneza tawi jipya** kwa mabadiliko yako 3. **Tengeneza tawi jipya** kwa mabadiliko yako
4. Fanya mabadiliko kwa maudhui ya somo au mifano ya msimbo 4. Fanya mabadiliko kwenye maudhui ya somo au mifano ya msimbo
5. Jaribu mabadiliko yoyote ya msimbo katika folda husika za miradi 5. Jaribu mabadiliko yoyote ya msimbo katika folda za miradi husika
6. Wasilisha ombi la kuunganisha (pull request) ukizingatia miongozo ya mchango 6. Wasilisha maombi ya pull baada ya kufuata miongozo ya mchango
### Kwa Wanafunzi ### Kwa Wanafunzi
1. Fungua au nakili hifadhidata 1. Fanya fork au clone ya hazina
2. Vuka kwenye folda za somo mfululizo 2. Tembelea folda za masomo kwa mfululizo
3. Soma faili za README za kila somo 3. Soma faili za README kwa kila somo
4. Kamilisha mitihani kabla ya somo katika https://ff-quizzes.netlify.app/web/ 4. Kamilisha mitihani ya kabla ya somo kwenye https://ff-quizzes.netlify.app/web/
5. Fanya kazi na mifano ya msimbo katika folda za masomo 5. Fanya kazi kupitia mifano ya msimbo katika folda za masomo
6. Kamilisha majukumu na changamoto 6. Kamilisha kazi za nyumbani na changamoto
7. Fanya mitihani baada ya somo 7. Fanya mitihani ya baada ya somo
### Maendeleo ya Moja kwa Moja ### Maendeleo ya Moja kwa Moja
- **Nyaraka**: Endesha `docsify serve` kutoka mzizi (bandari 3000) - **Nyaraka**: Endesha `docsify serve` kwenye mzizi (bandari 3000)
- **App ya Mitozo**: Endesha `npm run dev` katika folda ya quiz-app - **Quiz App**: Endesha `npm run dev` kwenye folda ya quiz-app
- **Miradi**: Tumia ugani wa VS Code Live Server kwa miradi ya HTML - **Miradi**: Tumia VS Code Live Server kwa miradi ya HTML
- **Miradi ya API**: Endesha `npm start` katika folda husika za API - **Miradi ya API**: Endesha `npm start` katika folda husika za API
## Maelekezo ya Kupima ## Maelekezo ya Kujaribu
### Kupima App ya Mitozo ### Kujaribu Quiz App
```bash ```bash
cd quiz-app cd quiz-app
npm run lint # Angalia matatizo ya mtindo wa msimbo npm run lint # Angalia matatizo ya mtindo wa msimbo
npm run build # Hakiki ujenzi unafanikiwa npm run build # Thibitisha kuwa ujenzi unafanikiwa
``` ```
### Kupima API ya Benki ### Kujaribu API ya Benki
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm run lint # Angalia matatizo ya mtindo wa msimbo npm run lint # Angalia matatizo ya mtindo wa msimbo
node server.js # Hakiki seva inaanza bila makosa node server.js # Thibitisha seva inaanza bila makosa
``` ```
### Njia ya Kupima kwa Ujumla ### Mbinu ya Kujaribu kwa Jumla
- Hii ni hifadhidata ya kielimu bila vipimo vya kiotomatiki kwa kina - Hii ni hazina ya elimu bila majaribio ya moja kwa moja kamili
- Ukaguzi wa mkono unalenga: - Kujaribu kwa mkono kunaangazia:
- Mifano ya msimbo ifanyike bila makosa - Mifano ya msimbo inaendesha bila makosa
- Viungo katika nyaraka vifanye kazi ipasavyo - Viungo katika nyaraka vinafanya kazi vizuri
- Ujenzi wa miradi ukamilike bila matatizo - Miradi inajengwa kwa mafanikio
- Mifano ifuatane na mbinu bora - Mifano inafuata mbinu bora
### Ukaguzi Kabla ya Kuwasilisha ### Ukaguzi Kabla ya Kuwasilisha
- Endesha `npm run lint` katika folda zenye package.json - Endesha `npm run lint` katika folda zilizo na package.json
- Hakiki viungo vya markdown - Hakiki viungo vya markdown ni sahihi
- Jaribu mifano ya msimbo kwenye kivinjari au Node.js - Jaribu mifano ya msimbo katika kivinjari au Node.js
- Hakiki tafsiri ziendelee na muundo sahihi - Angalia tafsiri zinadumisha muundo sahihi
## Miongozo ya Mtindo wa Msimbo ## Miongozo ya Mtindo wa Msimbo
### JavaScript ### JavaScript
- Tumia msimbo wa kisasa ES6+ - Tumia sintaksia ya kisasa ya ES6+
- Fuata mipangilio ya ESLint iliyopewa katika miradi - Fuata usanidi wa ESLint uliotolewa katika miradi
- Tumia majina yenye maana kwa mabadiliko na kazi kwa ufafanuzi wa kielimu - Tumia majina yenye maana kwa mabadiliko na kazi kwa uwazi wa elimu
- Ongeza maelezo kuelezea dhana kwa wanafunzi - Ongeza maelezo ya kuelezea dhana kwa wanafunzi
- Panga msimbo kwa Prettier pale panapopangwa - Fomatoa kwa kutumia Prettier pale inapopangwa
### HTML/CSS ### HTML/CSS
- Matumizi ya vipengele vya semantic HTML5 - Vipengele vya HTML5 vinavyofaa
- Kanuni za muundo unaojibadilisha (responsive design) - Kanuni za muundo unaojibadilisha (responsive)
- Mamlaka ya jina la daraja kwa uwazi - Miongozo wazi ya majina ya darasa
- Maelezo yanayoelezea mbinu za CSS kwa wanafunzi - Maelezo yanayobainisha mbinu za CSS kwa wanafunzi
### Python ### Python
- Miongozo ya mtindo wa PEP 8 - Miongozo ya mtindo wa PEP 8
- Mifano wazi, ya kielimu ya msimbo - Mifano wazi, ya elimu ya msimbo
- Maelezo ya aina (type hints) mahali panaposaidia kujifunza - Vidokezo vya aina ya data pale panaposaidia kujifunza
### Nyaraka za Markdown ### Nyaraka za Markdown
- Mipangilio wazi ya vichwa vya habari - Mpangilio wazi wa vichwa
- Vipande vya msimbo vyenye ufafanuzi wa lugha - Vizuizi vya msimbo na lugha iliyobainishwa
- Viungo kwa rasilimali za ziada - Viungo kwa rasilimali za ziada
- Picha na skrini katika folda za `images/` - Picha na skrini katika folda za `images/`
- Maelezo ya alt kwa picha kwa upatikanaji - Maandishi ya alt kwa picha kwa upatikanaji
### Mpangilio wa Faili ### Mpangilio wa Faili
- Masomo yamepangiwa nambari mfululizo (1-getting-started-lessons, 2-js-basics, n.k.) - Masomo yamewekwa nambari mfululizo (1-getting-started-lessons, 2-js-basics, n.k.)
- Kila mradi una folda za `solution/` na mara nyingi `start/` au `your-work/` - Kila mradi una folda ya `solution/` na mara nyingi `start/` au `your-work/`
- Picha zinahifadhiwa katika folda za somo maalum `images/` - Picha zimehifadhiwa katika folda maalum za masomo `images/`
- Tafsiri zinapatikana katika muundo wa `translations/{language-code}/` - Tafsiri ziko katika muundo wa folda `translations/{language-code}/`
## Ujenzi na Uenezaji ## Ujenzi na Utoaji
### Uenezaji wa App ya Mitozo (Azure Static Web Apps) ### Utoaji wa Quiz App (Azure Static Web Apps)
App ya quiz imewekwa kwa ajili ya uenezaji wa Azure Static Web Apps: Quiz-app imewekwa kwa ajili ya utoaji kwenye Azure Static Web Apps:
```bash ```bash
cd quiz-app cd quiz-app
npm run build # Inaunda folda ya dist/ npm run build # Inaunda folda ya dist/
# Inaendesha kupitia mtiririko wa GitHub Actions wakati wa kusukuma kwenye main # Inatekeleza kupitia mtiririko wa kazi wa GitHub Actions wakati wa kusukuma kwenye main
``` ```
Mipangilio ya Azure Static Web Apps: Mabadiliko ya Azure Static Web Apps:
- **Mahali pa App**: `/quiz-app` - **Mahali pa App**: `/quiz-app`
- **Mahali pa Matokeo**: `dist` - **Mahali pa Toa**: `dist`
- **Mtiririko wa Kazi**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` - **Mchakato wa Kazi**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Kutengeneza PDF ya Nyaraka ### Uundaji wa PDF wa Nyaraka
```bash ```bash
npm install # Sakinisha docsify-to-pdf npm install # Sakinisha docsify-to-pdf
@ -203,80 +203,80 @@ npm run convert # Tengeneza PDF kutoka kwa docs
### Nyaraka za Docsify ### Nyaraka za Docsify
```bash ```bash
npm install -g docsify-cli # Sakinisha Docsify kote npm install -g docsify-cli # Sambaza Docsify kimataifa
docsify serve # Hudumia kwenye localhost:3000 docsify serve # Tumikia kwenye localhost:3000
``` ```
### Ujenzi Maalum wa Miradi ### Ujenzi wa Miradi Maalum
Kila folda ya mradi inaweza kuwa na mchakato wake wa ujenzi: Kila folda ya mradi itaweza kuwa na mchakato wake wa ujenzi:
- Miradi ya Vue: `npm run build` huunda vifurushi vya uzalishaji - Miradi ya Vue: `npm run build` huunda pakiti za uzalishaji
- Miradi ya statiki: Hakuna hatua ya kujenga, anuguza faili moja kwa moja - Miradi ya static: Hakuna hatua ya ujenzi, hudumishwa faili moja kwa moja
## Miongozo ya Maombi ya Kuunganisha ## Miongozo ya Maombi ya Pull
### Muundo wa Kichwa ### Muundo wa Kichwa
Tumia vichwa wazi, vinavyoelezea sehemu ya mabadiliko: Tumia vichwa wazi, vinavyoelezea mabadiliko yaliyofanywa:
- `[Quiz-app] Ongeza mtihani mpya kwa somo X` - `[Quiz-app] Ongeza mtihani mpya kwa somo X`
- `[Lesson-3] Rekebisha tahajia katika mradi wa terrarium` - `[Lesson-3] Rekebisha typo katika mradi wa terrarium`
- `[Translation] Ongeza tafsiri ya Kihispania kwa somo 5` - `[Translation] Ongeza tafsiri ya Kihispania kwa somo 5`
- `[Docs] Sasisha maelekezo ya kuanzisha` - `[Docs] Sasisha maelekezo ya usanidi`
### Ukaguzi Unaotakiwa ### Ukaguzi unaohitajika
Kabla ya kuwasilisha PR: Kabla ya kuwasilisha PR:
1. **Ubora wa Msimbo**: 1. **Ubora wa Msimbo**:
- Endesha `npm run lint` katika folda za miradi zilizoathirika - Endesha `npm run lint` katika folda za miradi zilizoathirika
- Rekebisha makosa na onyo zote za lint - Rekebisha makosa na tahadhari zote za lint
2. **Thibitisha Ujenzi**: 2. **Uhakiki wa Ujenzi**:
- Endesha `npm run build` inapohitajika - Endesha `npm run build` kama inahitajika
- Hakikisha hakuna makosa ya ujenzi - Hakikisha hakuna makosa ya ujenzi
3. **Thibitisha Viungo**: 3. **Uthibitisho wa Viungo**:
- Jaribu viungo vyote vya markdown - Jaribu viungo vyote vya markdown
- Thibitisha marejeleo ya picha yanafanya kazi - Hakiki rejea za picha zinafanya kazi
4. **Uhakiki wa Maudhui**: 4. **Ukaguzi wa Maudhui**:
- Soma kwa tahajia na sarufi - Soma kwa makini spelling na sarufi
- Hakikisha mifano ya msimbo ni sahihi na ya kielimu - Hakikisha mifano ya msimbo ni sahihi na ya elimu
- Thibitisha tafsiri zinadumisha maana halisi - Thibitisha tafsiri zinahifadhi maana asili
### Mahitaji ya Mchango ### Masharti ya Mchango
- Kubali Microsoft CLA (ukaguzi wa kiotomatiki kwenye PR ya kwanza) - Kubali Microsoft CLA (ukaguzi wa moja kwa moja kwenye PR ya kwanza)
- Fuata [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) - Fuata [Kanuni ya Maadili ya Chanzo Huria ya Microsoft](https://opensource.microsoft.com/codeofconduct/)
- Tazama [CONTRIBUTING.md](./CONTRIBUTING.md) kwa miongozo kamili - Angalia [CONTRIBUTING.md](./CONTRIBUTING.md) kwa miongozo ya kina
- Taja nambari za masuala kwenye maelezo ya PR inapobidi - Taja nambari za masuala katika maelezo ya PR ikiwa zinahitajika
### Mchakato wa Ukaguzi ### Mchakato wa Ukaguzi
- PR hukaguliwa na watunzaji na jamii - PR zinakaguliwa na wasimamizi na jamii
- Uwafafanuzi wa kielimu unazingatiwa zaidi - Uwazekano wa elimu unazingatiwa
- Mifano ya msimbo ifuatane na mbinu bora za sasa - Mifano ya msimbo inapaswa kufuata mbinu bora za sasa
- Tafsiri hurejelewa kwa usahihi na muafaka wa kitamaduni - Tafsiri zinakaguliwa kwa usahihi na kuzingatia tamaduni
## Mfumo wa Tafsiri ## Mfumo wa Tafsiri
### Tafsiri ya Kiotomatiki ### Tafsiri za Moja kwa Moja
- Inatumia GitHub Actions na mtiririko wa co-op-translator - Inatumia GitHub Actions na mtiririko wa kazi wa co-op-translator
- Hufasiri kwa lugha 50+ moja kwa moja - Hutoa tafsiri za lugha 50+ kiotomatiki
- Faili chanzo ziko kwenye folda kuu - Faili za asili ziko katika folda kuu
- Faili zilizotafsiriwa ziko katika `translations/{language-code}/` - Faili zilizotafsiriwa ziko katika folda `translations/{language-code}/`
### Kuongeza Maboresho ya Tafsiri ya Mkono ### Kuongeza Maboresho ya Tafsiri kwa Mikono
1. Tafuta faili katika `translations/{language-code}/` 1. Tafuta faili katika `translations/{language-code}/`
2. Fanya maboresho bila kubadilisha muundo 2. Fanya maboresho huku ukidumisha muundo
3. Hakikisha mifano ya msimbo bado inafanya kazi 3. Hakikisha mifano ya msimbo inabaki pia kufanya kazi
4. Jaribu maudhui ya mtihani yaliyobinafsishwa 4. Jaribu maudhui yoyote ya mtihani yaliyoko kwa lugha hiyo
### Metadata ya Tafsiri ### Meta Data ya Tafsiri
Faili zilizotafsiriwa zina kichwa cha metadata: Faili zilizotafsiriwa zina kichwa cha meta data:
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
--> -->
``` ```
## Ugunduzi na Urekebishaji ## Utambuzi na Utatuzi wa Matatizo
### Masuala ya Kawaida ### Masuala Yaanayojitokeza Mara kwa Mara
**App ya mitihani haianzi**: **Quiz app haianzi**:
- Angalia toleo la Node.js (v14+ linapendekezwa) - Hakiki toleo la Node.js (v14+ inapendekezwa)
- Futa `node_modules` na `package-lock.json`, endesha tena `npm install` - Futa `node_modules` na `package-lock.json`, kisha endesha `npm install` tena
- Angalia migongano ya bandari (kawaida: Vite hutumia bandari 5173) - Hakiki migongano ya bandari (Vite kwa kawaida hutumia bandari 5173)
**Seva ya API haianzi**: **Seva ya API haishiriki**:
- Hakiki toleo la Node.js kuwa la chini kabisa (node >=10) - Hakiki toleo la Node.js linakidhi angalau (node >=10)
- Angalia kama bandari tayari inatumika - Angalia kama bandari tayari inatumika
- Hakikisha tegemezi zote zimesakinishwa kwa `npm install` - Hakikisha utegemezi wote umewekwa kwa kutumia `npm install`
**Kiongezi cha kivinjari hakifanyi kazi**: **Kiongezi cha kivinjari hakitolei mzigo**:
- Hakikisha manifest.json imeandikwa vizuri - Hakiki muundo wa manifest.json upo sawa
- Angalia makosa kwenye konsole ya kivinjari - Hakiki vibao vya makosa (console) vya kivinjari
- Fuata maelekezo ya usakinishaji ya kivinjari husika - Fuata maelekezo maalum ya usakinishaji wa kiongezi cha kivinjari
**Masuala ya mradi wa mazungumzo ya Python**: **Matatizo ya mradi wa mazungumzo ya Python**:
- Hakikisha kifurushi cha OpenAI kimesanikishwa: `pip install openai` - Hakikisha kifurushi cha OpenAI kimesakinishwa: `pip install openai`
- Hakiki mazingira ya GITHUB_TOKEN yamewekwa - Hakiki kwamba variable ya mazingira GITHUB_TOKEN imewekwa
- Angalia ruhusa za upatikanaji wa GitHub Models - Angalia ruhusa za ufikiaji wa GitHub Models
**Docsify haileti nyaraka**: **Docsify haiservi nyaraka**:
- Sakinisha docsify-cli ulimwenguni: `npm install -g docsify-cli` - Sakinisha docsify-cli kitaifa: `npm install -g docsify-cli`
- Endesha kutoka folda ya hifadhidata mzizi - Endesha kutoka kwa mzizi wa hazina
- Hakiki kuwa `docs/_sidebar.md` ipo - Hakiki kwamba `docs/_sidebar.md` ipo
### Vidokezo vya Mazingira ya Maendeleo ### Vidokezo vya Mazingira ya Maendeleo
- Tumia VS Code na ugani wa Live Server kwa miradi ya HTML - Tumia VS Code na programu-jalizi ya Live Server kwa miradi ya HTML
- Sakinisha ugani za ESLint na Prettier kwa panga msimbo mzuri - Sakinisha programu-jalizi za ESLint na Prettier kwa ulinganisho mzuri wa fomati
- Tumia DevTools za kivinjari kwa kufuatilia JavaScript - Tumia DevTools za kivinjari kwa utambuzi wa makosa ya JavaScript
- Kwa miradi ya Vue, install ugani wa Vue DevTools wa kivinjari - Kwa miradi ya Vue, sakinisha programu-jalizi ya Vue DevTools ya kivinjari
### Mambo ya Kufikiria Kuhusu Utendaji ### Mambo ya Kufikiria Kuhusu Utendaji
- Idadi kubwa ya faili zilizotafsiriwa (lugha 50+) husababisha nakala nzito - Idadi kubwa ya faili zilizotafsiriwa (lugha 50+) inafanya kloni kamili kuwa kubwa
- Tumia shallow clone kama unafanya kazi tu na maudhui: `git clone --depth 1` - Tumia shallow clone ikiwa unafanya kazi na maudhui pekee: `git clone --depth 1`
- Zuia tafsiri katika utafutaji unapotumia maudhui ya Kiingereza - Epuka tafsiri katika utafutaji wakati wa kazi za Kiingereza
- Mchakato wa ujenzi unaweza kuwa polepole mara ya kwanza (npm install, ujenzi wa Vite) - Michakato ya ujenzi inaweza kuchelewa mara ya kwanza (npm install, ujenzi wa Vite)
## Masuala ya Usalama ## Mambo ya Usalama
### Mabadiliko ya Mazingira ### Mabadiliko ya Mazingira
- Funguo za API hazipaswi kuwekwa hifadhidatani - Funguo za API hazipaswi kuwekwa kwenye hazina
- Tumia faili za `.env` (siku hizi ziko `.gitignore`) - Tumia faili `.env` (zimeorodheshwa tayari katika `.gitignore`)
- Elezea mabadiliko ya mazingira yanayohitajika kwenye README za miradi - Elezea mabadiliko ya mazingira yanayohitajika katika README za miradi
### Miradi ya Python ### Miradi ya Python
- Tumia mazingira ya mtandao wa virtual: `python -m venv venv` - Tumia mazingira ya virtual: `python -m venv venv`
- Sasisha tegemezi mara kwa mara - Shikilia utegemezi umeboreshwa
- Tokeni za GitHub ziwe na idhini kidogo inayohitajika - Tokeni za GitHub ziwe na ruhusa ndogo zinazohitajika pekee
### Upatikanaji wa GitHub Models ### Ufikiaji wa GitHub Models
- Tokens za Upatikanaji wa Kibinafsi (PAT) zinahitajika kwa GitHub Models - Tokeni za Ufikiaji wa Binafsi (PAT) zinahitajika kwa GitHub Models
- Tokens ziwekewe kama mabadiliko ya mazingira (environment variables) - Tokeni zipo hifadhiwa kama mabadiliko ya mazingira
- Usiweze kuweka tokens au nyaraka za usalama hifadhidatani - Kamwe usiweka tokeni au vitambulisho kwenye hazina
## Vidokezo Zaidi ## Vidokezo Zaidi
### Walengwa ### Hadhira Lengwa
- Wanaoanza kabisa katika maendeleo ya wavuti - Waanzilishi kamili wa maendeleo ya wavuti
- Wanafunzi na wanaojifunza peke yao - Wanafunzi na wanaojifunza peke yao
- Walimu wanaotumia mtaala darasani - Walimu wanaotumia mtaala darasani
- Maudhui yameundwa kwa upatikanaji na uelekezaji wa hatua kwa hatua - Maudhui yameundwa kwa upatikanaji na ukuaji wa ujuzi polepole
### Falsafa ya Elimu ### Falsafa ya Elimu
- Mbinu ya kujifunza kwa miradi - Mbinu za kujifunza kwa mradi
- Ukaguzi wa mara kwa mara wa maarifa (mitihani) - Vipimo vya mara kwa mara vya maarifa (quiz)
- Mazoezi ya msimbo ya vitendo - Mazoezi ya msimbo kwa vitendo
- Mifano halisi ya utekelezaji - Mifano ya matumizi halisi
- Lengo la msingi kabla ya majukwaa - Kuzingatia misingi kabla ya fremu za kazi
### Matunzo ya Hifadhidata ### Matengenezo ya Hazina
- Jamii hai ya wanafunzi na wachangiaji - Jamii yenye shughuli za wanafunzi na wachangiaji
- Sasisho la mara kwa mara kwa tegemezi na maudhui - Sasisho za mara kwa mara vya utegemezi na maudhui
- Masuala na mijadala ikifuatiliwa na watunzaji - Masuala na majadiliano yanasimamiwa na wasimamizi
- Sasisho za tafsiri kwa njia ya kiotomatiki kupitia GitHub Actions - Sasisho za tafsiri za moja kwa moja kupitia GitHub Actions
### Rasilimali Zinazohusiana ### Rasilimali Zinazohusiana
- [Moduli za Microsoft Learn](https://docs.microsoft.com/learn/) - [Moduli za Microsoft Learn](https://docs.microsoft.com/learn/)
- [Rasilimali za Student Hub](https://docs.microsoft.com/learn/student-hub/) - [Rasilimali za Student Hub](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) inapendekezwa kwa wanaojifunza - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) inapendekezwa kwa wanafunzi
- Kozi za ziada: AI ya Asili, Sayansi ya Takwimu, ML, na mtaala wa IoT zinapatikana - Kozi za ziada: AI Inayotengeneza, Sayansi ya Data, ML, na mtaala wa IoT upo
### Kufanya Kazi na Miradi Maalum ### Kufanya Kazi na Miradi Maalum
Kwa maelekezo ya kina juu ya miradi binafsi, rejelea faili za README katika: Kwa maelekezo ya undani kuhusu miradi binafsi, rejelea faili za README katika:
- `quiz-app/README.md` - Programu ya mtihani ya Vue 3 - `quiz-app/README.md` - Programu ya quiz ya Vue 3
- `7-bank-project/README.md` - Programu ya benki yenye uthibitishaji - `7-bank-project/README.md` - Programu ya benki yenye uthibitishaji
- `5-browser-extension/README.md` - Ukuaji wa kiongezi cha kivinjari - `5-browser-extension/README.md` - Maendeleo ya kiongezi cha kivinjari
- `6-space-game/README.md` - Ukuaji wa mchezo wa Canvas - `6-space-game/README.md` - Uundaji wa mchezo wa Canvas
- `9-chat-project/README.md` - Mradi wa msaidizi wa mazungumzo wa AI - `9-chat-project/README.md` - Mradi wa msaidizi wa mazungumzo wa AI
### Muundo wa Monorepo ### Muundo wa Monorepo
Ingawa si monorepo ya kawaida, hifadhidata hii ina miradi huru mingi: Ingawa si monorepo ya kawaida, hazina hii ina miradi huru mingi:
- Kila somo ni huru - Kila somo ni huru
- Miradi haiungi mkono tegemezi zao - Miradi haiwasiliani katika utegemezi
- Fanya kazi kwenye miradi binafsi bila kuathiri mingine - Fanya kazi kwenye miradi binafsi bila kuathiri mingine
- Nakili hifadhidata yote kwa uzoefu kamili wa mtaala - Clone hazina nzima kwa uzoefu wa mtaala kamili
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Kiarifu cha Kutokujali**: **Tangazo la kutokujali**:
Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI [Co-op Translator](https://github.com/Azure/co-op-translator). Ingawa tunajitahidi kwa usahihi, tafadhali kumbuka kuwa tafsiri za moja kwa moja zinaweza kuwa na makosa au upungufu wa usahihi. Hati ya asili katika lugha yake ya mama inapaswa kuchukuliwa kama chanzo halali. Kwa taarifa muhimu, tafsiri ya mtaalamu wa kibinadamu inapendekezwa. Hatutawajibika kwa changamoto au tafsiri zisizo sahihi zinazotokana na matumizi ya tafsiri hii. Nyaraka hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI [Co-op Translator](https://github.com/Azure/co-op-translator). Ingawa tunajitahidi kwa usahihi, tafadhali fahamu kwamba tafsiri za kiotomatiki zinaweza kuwa na makosa au utata. Nyaraka ya asili kwa lugha yake ya asili inapaswa kuzingatiwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya kitaalamu ya binadamu inapendekezwa. Hatuwajibiki kwa kutoelewana au tafsiri zisizo sahihi zinazotokana na matumizi ya tafsiri hii.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->
Loading…
Cancel
Save