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

pull/1793/head
localizeflow[bot] 5 months ago
parent eeb49d1ae2
commit 2fae1b526d

@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T15:52:25+00:00", "translation_date": "2026-04-20T16:56:14+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "cs" "language_code": "cs"
}, },

@ -2,29 +2,29 @@
## Přehled projektu ## Přehled projektu
Toto je vzdělávací repozitář kurikula pro výuku základů webového vývoje pro začátečníky. Kurikulum je komplexní 12týdenní kurz vyvinutý Microsoft Cloud Advocates, obsahující 24 praktických lekcí zaměřených na JavaScript, CSS a HTML. Toto je vzdělávací repozitář kurikula pro výuku základů webového vývoje pro začátečníky. Kurikulum je komplexní 12týdenní kurz vyvinutý týmem Microsoft Cloud Advocates, obsahující 24 praktických lekcí pokrývajících JavaScript, CSS a HTML.
### Klíčové součásti ### 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í uspořádaných do modulů založených na projektech
- **Praktické projekty**: Terrárium, Hra na psaní, Rozšíření prohlížeče, Vesmírná hra, Bankovní aplikace, Kódový editor a AI Chat asistent - **Praktické projekty**: Terrárium, Hra na psaní, Prodlžek prohlížeče, Hra ve vesmíru, Bankovní aplikace, Kódový editor a AI chatovací asistent
- **Interaktivní kvízy**: 48 kvízů s 3 otázkami každého (před a po lekci) - **Interaktivní kvízy**: 48 kvízů po 3 otázkách (testy před a po lekci)
- **Podpora vícejazyčnosti**: Automatizované překlady do více než 50 jazyků pomocí GitHub Actions - **Podpora více jazyků**: Automatizované překlady do více než 50 jazyků pomocí GitHub Actions
- **Technologie**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (pro AI projekty) - **Technologie**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (pro AI projekty)
### Architektura ### Architektura
- Vzdělávací repozitář se strukturou založenou na lekcích - Vzdělávací repozitář se strukturou založenou na lekcích
- Každá složka lekce obsahuje README, příklady kódu a řešení - 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ůznorodé projekty lekcí) - 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) - Překladový systém využívající GitHub Actions (co-op-translator)
- Dokumentace poskytována přes Docsify a dostupná jako PDF - Dokumentace podávaná přes Docsify a dostupná jako PDF
## Příkazy pro nastavení ## Příkazy k nastavení
Tento repozitář je primárně určen ke konzumaci vzdělávacího obsahu. Pro práci s konkrétními projekty: Tento repozitář je primárně určen pro konzumaci vzdělávacího obsahu. Pro práci s konkrétními projekty:
### Hlavní nastavení repozitáře ### Nastavení hlavního repozitáře
```bash ```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
@ -48,10 +48,10 @@ cd 7-bank-project/api
npm install npm install
npm start # Spusťte API server npm start # Spusťte API server
npm run lint # Spusťte ESLint npm run lint # Spusťte ESLint
npm run format # Formátujte pomocí Prettier npm run format # Naformátujte pomocí Prettier
``` ```
### Projekty rozšíření prohlížeče ### Projekty pro prodloužení prohlížeče
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
@ -59,7 +59,7 @@ npm install
# Postupujte podle pokynů pro načítání rozšíření specifických pro prohlížeč # Postupujte podle pokynů pro načítání rozšíření specifických pro prohlížeč
``` ```
### Projekty vesmírné hry ### Projekty hry ve vesmíru
```bash ```bash
cd 6-space-game/solution cd 6-space-game/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
``` ```
### Chat projekt (Python Backend) ### Chatovací projekt (Python Backend)
```bash ```bash
cd 9-chat-project/solution/backend/python cd 9-chat-project/solution/backend/python
@ -76,120 +76,120 @@ pip install openai
python api.py python api.py
``` ```
## Vývojový workflow ## Vývojový pracovní postup
### Pro přispěvovatele obsahu ### Pro přispěvatele obsahu
1. **Forkujte repozitář** do svého GitHub účtu 1. **Vytvořte fork** repozitáře do svého GitHub účtu
2. **Klonujte svůj fork** lokálně 2. **Klonujte svůj fork** 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 lekcí nebo příkladech kódu 4. Proveďte změny ve vzdělávacím obsahu nebo příkladech kódu
5. Testujte jakékoliv změny kódu v příslušných adresářích projektů 5. Otestujte jakékoliv změny kódu v příslušných adresářích projektů
6. Odešlete pull requesty podle pokynů pro přispívání 6. Odešlete pull requesty dle pokynů pro přispívání
### Pro studenty ### Pro studenty
1. Forkujte nebo klonujte repozitář 1. Vytvořte fork nebo klonujte repozitář
2. Procházejte složky lekcí sekvenč 2. Procházejte adresáře lekcí postup
3. Čtěte README soubory každé lekce 3. Čtěte README soubory ke každé lekci
4. Dokončete před- lekční kvízy na https://ff-quizzes.netlify.app/web/ 4. Dokončete kvízy před lekcí na https://ff-quizzes.netlify.app/web/
5. Procházejte příklady kódu ve složkách lekcí 5. Procházejte příklady kódu v adreřích lekcí
6. Dokončete úkoly a výzvy 6. Splňte úkoly a výzvy
7. Udělejte post- lekční kvízy 7. Dokončete kvízy po lekci
### Živý vývoj ### Živý vývoj
- **Dokumentace**: Spusťte `docsify serve` v kořenovém adresáři (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 rozšíření VS Code Live Server pro HTML projekty
- **API projekty**: Spusťte `npm start` v příslušných API adresářích - **API projekty**: Spusťte `npm start` v příslušných API adresářích
## Instrukce k testování ## Pokyny k 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 sestavení proběhne úspěšně npm run build # Ověřte, zda sestavení proběhne ú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 kódovacím stylem 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, že server startuje bez chyb
``` ```
### Obecný přístup k testování ### Obecný přístup k testování
- Toto je vzdělávací repozitář bez komplexních automatizovaných testů - Jedná se o vzdělávací repozitář bez komplexních automatizovaných testů
- Manuální testování se zaměřuje na: - Manuální testování se zaměřuje na:
- Příkladový kód bez chyb při spuštění - Příklady kódu bez chyb při spuštění
- Funkčnost odkazů v dokumentaci - Funkčnost odkazů v dokumentaci
- Úspěšné sestavení projektů - Úspěšné dokončení buildů projektů
- Příklady vyhovují zásadám best practices - Dodržování osvědčených postupů v příkladech
### Kontroly před odesláním změn ### Kontroly před odesláním PR
- 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, že odkazy v markdownu jsou platné - Ověřte platnost markdown odkazů
- Otestujte 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 správnou strukturu překladů
## Směrnice stylu kódu ## Směrnice pro styl kódu
### JavaScript ### JavaScript
- Používejte moderní ES6+ syntaxi - Používejte moderní syntax ES6+
- Dodržujte standardní konfigurace ESLint v projektech - Dodržujte standardní konfigurace ESLint v projektech
- Používejte názvy proměnných a funkcí, které jsou srozumitelné pro výuku - Používejte srozumitelné názvy proměnných a funkcí pro vzdělávací přehlednost
- Přidávejte komentáře vysvětlující koncepty pro studenty - Přidávejte komentáře vysvětlující koncepty studentům
- Formátujte pomocí Prettier tam, kde je nakonfigurováno - Formátujte pomocí Prettier tam, kde je nastaven
### HTML/CSS ### HTML/CSS
- Semantické HTML5 prvky - Sémantické HTML5 prvky
- 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
- Směrnice stylu PEP 8 - Dodržujte PEP 8 styl
- Jasné, vzdělávací příklady kódu - Jasné, vzdělávací příklady kódu
- Typové nápovědy tam, kde pomáhají s učením - Používejte typové nápovědy, kde to pomáhá učení
### Markdown dokumentace ### Dokumentace v Markdown
- Jasná hierarchie nadpisů - Přehledná hierarchie nadpisů
- Bloky kódu s označením jazyka - Kódové bloky s uvedením jazyka
- Odkazy na doplňkové zdroje - Odkazy na další zdroje
- Screenshoty a obrázky ve složkách `images/` - Snímky obrazovky a obrázky v adresářích `images/`
- Alternativní texty pro obrázky pro přístupnost - Alternativní text obrázků pro přístupnost
### 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, atd.)
- Každý projekt má složky `solution/` a často `start/` nebo `your-work/` - Každý projekt má adresáře `solution/` a často `start/` nebo `your-work/`
- Obrázky uložené v lekcemi specifických složkách `images/` - Obrázky uložené ve složkách `images/` specifických pro lekce
- Překlady ve struktuře `translations/{language-code}/` - Překlady v adresářové struktuře `translations/{language-code}/`
## Sestavení a nasazení ## Sestavení a nasazení
### Nasazení Quiz App (Azure Static Web Apps) ### Nasazení Quiz App (Azure Static Web Apps)
Quiz-app je nastaven pro nasazení na Azure Static Web Apps: Quiz-app je nakonfigurován pro nasazení pomocí Azure Static Web Apps:
```bash ```bash
cd quiz-app cd quiz-app
npm run build # Vytváří složku dist/ npm run build # Vytváří složku dist/
# Nasazuje přes workflow GitHub Actions při pushnutí na main # Nasazuje pomocí workflow GitHub Actions při push na main
``` ```
Konfigurace Azure Static Web Apps: Konfigurace Azure Static Web Apps:
- **Místo aplikace**: `/quiz-app` - **Umístění aplikace**: `/quiz-app`
- **Výstupní umístění**: `dist` - **Výstupní umístění**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
@ -197,82 +197,82 @@ Konfigurace Azure Static Web Apps:
```bash ```bash
npm install # Nainstalujte docsify-to-pdf npm install # Nainstalujte docsify-to-pdf
npm run convert # Vygenerujte PDF z docs npm run convert # Vytvořte PDF z docs
``` ```
### Dokumentace Docsify ### Dokumentace přes Docsify
```bash ```bash
npm install -g docsify-cli # Nainstalujte Docsify globálně npm install -g docsify-cli # Nainstalujte Docsify globálně
docsify serve # Serve na localhost:3000 docsify serve # Spusťte na localhost:3000
``` ```
### Sestavení specifická pro projekty ### Sestavení specifická pro projekt
Každý projekt může mít vlastní sestavovací proces: Každý projekt 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ý sestavovací krok, soubory se přímo servírují - Statické projekty: Žádný build, soubory se podávají přímo
## Směrnice pro pull requesty ## Směrnice pro pull requesty
### Formát názvů ### Formát názvu
Používejte jasné, popisné názvy indikující oblast změny: Používejte jasné, popisné názvy uvádějí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 projekt terrária` - `[Lesson-3] Opravit překlep v projektu terrárium`
- `[Translation] Přidat španělský překlad pro lekci 5` - `[Translation] Přidat španělský překlad pro lekci 5`
- `[Docs] Aktualizace instrukcí pro nastavení` - `[Docs] Aktualizovat instrukce k nastavení`
### Požadované kontroly ### Požadované 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` ve zasažených projech složkách - Spusťte `npm run lint` v dotčených projektech
- Opravte všechny linting chyby a varování - Opravte všechny lintovací chyby a varování
2. **Ověření sestavení**: 2. **Ověření buildů**:
- Spusťte `npm run build` pokud je to relevantní - Spusťte `npm run build` pokud je relevantní
- Zajistěte, že nejsou chyby při sestavení - Ujistěte se, že build proběhl bez chyb
3. **Validace odkazů**: 3. **Kontrola odkazů**:
- Otestujte všechny markdown odkazy - Otestujte všechny markdown odkazy
- Ověřte funkčnost odkazů na obrázky - Ověřte pracovní odkazy na obrázky
4. **Kontrola obsahu**: 4. **Kontrola obsahu**:
- Korektura pravopisu a gramatiky - Korektura pravopisu a gramatiky
- Ověření správnosti a vzdělávací hodnoty příkladů kódu - Zajištění správnosti a vzdělávací hodnoty příkladů kódu
- Validace, že překlady zachovávají původní význam - Ověření správnosti překladů
### Požadavky na přispívání ### Požadavky na přispívání
- Souhlas se smlouvou Microsoft CLA (automatická kontrola při prvním PR) - Souhlas s Microsoft CLA (automatická kontrola při prvním PR)
- Dodržování [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) - Dodržování [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
- Odkazování na čísla issues v popisu PR, pokud je to relevantní - Uvádějte čísla issue v popisu PR, pokud jsou relevantní
### Proces revize ### Proces revize
- PRs jsou revidovány správci i komunitou - PR kontrolují správci a komunita
- Prioritizuje se vzdělávací srozumitelnost - Upřednostňuje se vzdělávací jasnost
- Příklady kódu by měly odpovídat aktuálním best practices - Příklady kódu by měly odpovídat současným osvědčeným postupům
- Překlady jsou kontrolovány na přesnost a kulturní vhodnost - Překlady se kontrolují na 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
- Překládá do více než 50 jazyků automaticky - 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/{language-code}/` - Přeložené soubory v adresářích `translations/{language-code}/`
### Přidání manuálních vylepšení překladu ### Přidání ručních vylepšení překladu
1. Najděte soubor v `translations/{language-code}/` 1. Najděte soubor v `translations/{language-code}/`
2. Proveďte vylepšení při zachování struktury 2. Proveďte vylepšení při zachování struktury
3. Zajistěte, že příklady kódu zůstanou funkční 3. Zajistěte funkčnost příkladů kódu
4. Otestujte případný lokalizovaný obsah kvízů 4. Otestujte případný lokalizovaný kvízový obsah
### Metadata překladu ### Metadata překladu
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
--> -->
``` ```
## Ladění a odstraňování potíží ## Ladění a řešení problémů
### Běžné problémy ### Běžné problémy
**Quiz app se nespustí**: **Quiz app se nespustí**:
- Zkontrolujte verzi Node.js (doporučeno v14+) - Zkontrolujte verzi Node.js (doporučeno v14+)
- Odstraňte `node_modules` a `package-lock.json`, znovu spusťte `npm install` - Odstraňte `node_modules` a `package-lock.json`, spusťte `npm install` znovu
- Zkontrolujte konflikty portu (výchozí: Vite používá port 5173) - Zkontrolujte konflikty portů (výchozí: Vite používá port 5173)
**API server se nespustí**: **API server se nespustí**:
- Ověřte verzi Node.js (node >=10) - Ověřte minimální verzi Node.js (node >=10)
- Zkontrolujte, zda port není již obsazen - Zkontrolujte, zda port není obsazen
- Ujistěte se, že všechny závislosti jsou nainstalovány pomocí `npm install` - Ujistěte se, že všechny závislosti jsou nainstalovány pomocí `npm install`
**Rozšíření prohlížeče se nenačte**: **Prodlžek prohlížeče se nenačítá**:
- Ověřte správné formátování manifest.json - Zkontrolujte, že manifest.json je správně formátován
- Kontrolujte konzoli prohlížeče na chyby - Prohlédněte konzoli prohlížeče kvůli chybám
- Postupujte podle specifických instrukcí pro instalaci rozšíření v daném prohlížeči - Postupujte podle specifických instrukcí pro instalaci prodlužků v prohlížeči
**Problémy s Python chat projektem**: **Problémy s Python chat projektem**:
- Ujistěte se, že je nainstalovaný balíček OpenAI: `pip install openai` - Ujistěte se, že je nainstalován balík OpenAI: `pip install openai`
- Ověřte nastavení proměnné prostředí GITHUB_TOKEN - Zkontrolujte, že je nastavena proměnná prostředí GITHUB_TOKEN
- Zkontrolujte oprávnění přístupu k GitHub Models - Prověřte oprávnění přístupu k GitHub Models
**Docsify neslouží dokumentaci**: **Docsify nedoručuje dokumenty**:
- Nainstalujte docsify-cli globálně: `npm install -g docsify-cli` - Globálně nainstalujte docsify-cli: `npm install -g docsify-cli`
- Spouštějte z kořenového adresáře repozitáře - Spusťte ze základního adresáře repozitáře
- Ověřte, že existuje `docs/_sidebar.md` - Ověřte, že existuje `docs/_sidebar.md`
### Tipy pro vývojové prostředí ### Tipy pro vývojové prostředí
- Používejte VS Code s Live Server rozšířením pro HTML projekty - Používejte VS Code s rozšířením Live Server pro HTML projekty
- Instalujte rozšíření ESLint a Prettier pro konzistentní formátování - Nainstalujte rozšíření ESLint a Prettier pro konzistentní formátování
- Používejte DevTools prohlížeče pro ladění JavaScriptu - Používejte DevTools prohlížeče pro ladění JavaScriptu
- Pro Vue projekty instalujte Vue DevTools rozšíření prohlížeče - Pro Vue projekty použijte Vue DevTools rozšíření do prohlížeče
### Výkonové aspekty ### Výkonnostní úvahy
- Velké množství přeložených souborů (50+ jazyků) znamená velké klony repozitáře - Velké množství přeložených souborů (50+ jazyků) znamená, že plné klony jsou rozsáhlé
- Použijte shallow clone, pokud pracujete jen s obsahem: `git clone --depth 1` - Použijte shallow clone, pokud pracujete jen 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 s angličtinou vylučte překlady z hledání
- Sestavovací procesy mohou být pomalé při prvním spuštění (npm install, Vite build) - Build procesy mohou být pomalé při prvním spuštění (npm install, Vite build)
## Bezpečnostní aspekty ## Bezpečnostní aspekty
### Proměnné prostředí ### Proměnné prostředí
- API klíče by neměly být nikdy commitnuty do repozitáře - API klíče nikdy nesmí být commitovány do repozitáře
- Používejte `.env` soubory (jsou v `.gitignore`) - Používejte `.env` soubory (jsou v `.gitignore`)
- Dokumentujte požadované proměnné prostředí v README projektů - Dokumentujte požadované proměnné prostředí v README projektů
### Python projekty ### Python projekty
- Používejte virtuální prostředí: `python -m venv venv` - Používejte virtuální prostředí: `python -m venv venv`
- Udržujte závislosti aktualizované - Udržujte závislosti aktuální
- GitHub tokeny by měly mít minimální potřebná oprávnění - GitHub tokeny by měly mít minimální potřebná oprávnění
### Přístup k GitHub Models ### Přístup k GitHub Models
- Vyžaduje se osobní přístupový token (PAT) - Pro GitHub Models jsou vyžadovány Personal Access Tokens (PAT)
- Tokeny ukládejte jako proměnné prostředí - Tokeny ukládejte jako proměnné prostředí
- Nikdy necommitujte tokeny nebo přihlašovací údaje - Nikdy nesdílejte tokeny ani přihlašovací údaje v repozitáři
## Další poznámky ## Další poznámky
### Cílová skupina ### Cílové publikum
- Kompletní začátečníci ve webovém vývoji - Absolutní 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é používající kurikulum ve třídách
- Obsah je 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 ### Vzdělávací filozofie
- Případová výuka založená na projektech - Přístup založený na projektech
- Časté kontroly znalostí (kvízy) - Časté kontroly znalostí (kvízy)
- Praktické programovací cvičení - Praktické kódovací cvičení
- Příklady reálného použití - Příklady aplikací 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
- Problémy a diskuze monitorované správci - Problémy a diskuse spravovány správci
- Automatické aktualizace překladů přes GitHub Actions - Aktualizace překladů 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čeno 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: Generativní AI, Data Science, ML, IoT dostupné kurikula
### Práce s konkrétními projekty ### Práce s konkrétními projekty
Pro detailní instrukce k jednotlivým projektům odkazujte na README soubory v: Pro detailní instrukce u jednotlivých projektů nahlédněte do README souborů:
- `quiz-app/README.md` - Vue 3 aplikace kvízu - `quiz-app/README.md` - Vue 3 aplikace kvízu
- `7-bank-project/README.md` - Bankovní aplikace s ověřováním - `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 prodlužků prohlížeče
- `6-space-game/README.md` - Vývoj hry založené na canvasu - `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ž nejde o tradiční monorepo, tento repozitář obsahuje více nezávislých projektů: I když nejde o tradiční monorepo, tento repozitář obsahuje několik nezávislých projektů:
- Každá lekce je samostatná - Každá lekce je samostatná
- Projekty nesdílí závislosti - Projekty nesdílí závislosti
- Práce na jednotlivých projektech bez ovlivnění ostatních - Práce na jednotlivých projektech neovlivňuje ostatní
- Klonujte celý repozitář pro plný zážitek z kurikula - Naklonujte celý repozitář pro plný zážitek kurikula
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Upozornění**: **Prohlášení o vyloučení odpovědnosti**:
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 autorizovaný zdroj. Pro zásadní informace se doporučuje profesionální lidský překlad. Nejsme odpovědni za žádné nedorozumění či chybné interpretace 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 automatické překlady mohou obsahovat chyby nebo nepřesnosti. Původní dokument v jeho rodném jazyce by měl být považován za autoritativní zdroj. Pro důležité informace se doporučuje profesionální lidský překlad. Nejsme zodpovědní za jakákoliv nedorozumění nebo nesprávné výklady vyplývající z použití tohoto překladu.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T15:51:17+00:00", "translation_date": "2026-04-20T16:55:06+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "hu" "language_code": "hu"
}, },

@ -1,28 +1,28 @@
# AGENTS.md # AGENTS.md
## Projekt áttekintés ## Projekt Áttekintés
Ez egy oktatási tananyag tárhely, 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, és 24 gyakorlati leckét tartalmaz JavaScript, CSS és HTML témakörökben. Ez egy oktatási tanterv-tárhely, amely 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, és 24 gyakorlati leckét tartalmaz, amelyek JavaScriptet, CSS-t és HTML-t fednek le.
### Főbb elemek ### Főbb összetevők
- **Oktatási tartalom**: 24 strukturált lecke, projekt alapú modulokba rendezve - **Oktatási tartalom**: 24 strukturált lecke, amely projektalapú modulokba rendezett
- **Gyakorlati projektek**: Terrárium, gépelős játék, böngészőbővítmény, űrjáték, banki alkalmazás, kódszerkesztő és AI chat asszisztens - **Gyakorlati projektek**: Terrárium, Gépelő játék, Böngésző kiterjesztés, Űr játék, Bank alkalmazás, Kód szerkesztő és AI chat asszisztens
- **Interaktív kvízek**: 48 kvíz, mindegyikben 3 kérdés (elő- és utóleckés értékelés) - **Interaktív kvízek**: 48 kvíz, mindegyik 3 kérdéssel (leckék előtti/utáni értékelések)
- **Többnyelvű támogatás**: Automatikus fordítás 50+ nyelvre GitHub Actions használatával - **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árhely lecke-alapú szerkezettel - Oktatási tárhely leckealapú felépítéssel
- Minden lecke mappa tartalmaz README fájlt, kód példákat és megoldásokat - Minden lecke mappa tartalmaz README-t, kód pé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önféle lecke projektek)
- Fordítási rendszer GitHub Actions segítségével (co-op-translator) - Fordítási rendszer GitHub Actions használatával (co-op-translator)
- Dokumentáció Docsify-n keresztül elérhető és PDF-ként is rendelkezésre áll - Dokumentáció Docsify segítségével szolgálva, PDF formátumban is elérhető
## Beállítási parancsok ## Beállítási parancsok
Ez a tárhely elsősorban oktatási tartalom fogyasztására szolgál. Az egyes projektek használatához: Ez a tárhely elsősorban oktatási tartalom fogyasztására szolgál. Specifikus projektekkel való munkához:
### Fő tárhely beállítása ### Fő tárhely beállítása
@ -31,14 +31,14 @@ git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners cd Web-Dev-For-Beginners
``` ```
### Quiz App beállítása (Vue 3 + Vite) ### Kvíz alkalmazás beállítása (Vue 3 + Vite)
```bash ```bash
cd quiz-app cd quiz-app
npm install npm install
npm run dev # Fejlesztői szerver indítása npm run dev # Indítsa el a fejlesztői szervert
npm run build # Build előállítása éles környezetre npm run build # Készítsen buildet produkcióhoz
npm run lint # ESLint futtatása npm run lint # Futtassa az ESLint-et
``` ```
### Bank projekt API (Node.js + Express) ### Bank projekt API (Node.js + Express)
@ -51,23 +51,23 @@ npm run lint # Futtassa az ESLint-et
npm run format # Formázás Prettier-rel npm run format # Formázás Prettier-rel
``` ```
### Böngészőbővítmény projektek ### Böngésző kiterjesztés projektek
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
npm install npm install
# Kövesse a böngészőspecifikus kiterjesztés betöltési utasításait # 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 ```bash
cd 6-space-game/solution cd 6-space-game/solution
npm install npm install
# Nyisd meg az index.html fájlt böngészőben vagy használd a Live Server-t # Nyisd meg az index.html fájlt a böngészőben vagy használd a Live Servert
``` ```
### Chat projekt (Python backend) ### Chat projekt (Python háttér)
```bash ```bash
cd 9-chat-project/solution/backend/python cd 9-chat-project/solution/backend/python
@ -78,205 +78,205 @@ python api.py
## Fejlesztési munkafolyamat ## Fejlesztési munkafolyamat
### Tartalomközreműködőknek ### Tartalom hozzájárulók számára
1. **Forkold le a tárhelyet** a GitHub fiókodba 1. **Forkoljuk a tárhelyet** a saját GitHub fiókunkba
2. **Clone-old le lokálisan** a saját forkodat 2. **Klonoljuk a forkot** helyileg
3. **Hozz létre egy új ágat** a változtatásaidnak 3. **Hozzunk létre új ágat** a változtatásokhoz
4. Végezze el a változtatásokat a leckék tartalmában vagy kódpéldákban 4. Végezzen változtatásokat a lecke tartalmában vagy kód példákban
5. Teszteld a kódváltozásokat a projekt könyvtárakban 5. Teszteljük a kódváltozásokat a kapcsolódó projekt könyvtárakban
6. Küldj be pull request-et a hozzájárulási irányelvek szerint 6. Küldjünk be pull requesteket a hozzájárulási irányelvek szerint
### Tanulóknak ### Tanulók számára
1. Forkold vagy clone-ld le a tárhelyet 1. Forkoljuk vagy klonoljuk a tárhelyet
2. Haladj sorban a lecke könyvtárakban 2. Lépjünk végig sorban a lecke könyvtárakon
3. Olvasd el az egyes leckék README fájljait 3. Olvassuk el az egyes leckék README fájljait
4. Töltsd ki a tanulás előtti kvízeket a https://ff-quizzes.netlify.app/web/ oldalon 4. Töltsük ki a lecke előtti kvízeket a https://ff-quizzes.netlify.app/web/ oldalon
5. Haladj a lecke mappák kódpéldáin keresztül 5. Dolgozzunk a lecke mappákban lévő kód példákon
6. Végezd el a feladatokat és kihívásokat 6. Teljesítsük a feladatokat és kihívásokat
7. Töltsd ki az utóleckés kvízeket 7. Írjuk meg a lecke utáni kvízeket
### Élő fejlesztés ### Élő fejlesztés
- **Dokumentáció**: Futtasd a `docsify serve` parancsot a gyökérben (3000-es port) - **Dokumentáció**: Fussuk a `docsify serve` parancsot a gyökérben (3000-es port)
- **Quiz App**: Futtasd az `npm run dev` parancsot a quiz-app könyvtárban - **Kvíz alkalmazás**: Fussuk az `npm run dev` parancsot a quiz-app könyvtárban
- **Projektek**: Használd a VS Code Live Server kiterjesztést HTML projektekhez - **Projektek**: Használjuk a VS Code Live Server bővítményét HTML projektekhez
- **API projektek**: Futassd az `npm start` parancsot a megfelelő API könyvtárakban - **API projektek**: Fussuk az `npm start` parancsot az adott API könyvtárakban
## Tesztelési utasítások ## Tesztelési útmutató
### Quiz App tesztelése ### Kvíz alkalmazás tesztelése
```bash ```bash
cd quiz-app cd quiz-app
npm run lint # Ellenőrizze a kódstílus problémákat npm run lint # Ellenőrizze a kódstílus problémákat
npm run build # Ellenőrizze, hogy a build sikeres-e npm run build # Ellenőrizze, hogy a build sikeres legyen
``` ```
### Bank API tesztelése ### Bank API tesztelése
```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ód stílusproblémáit
node server.js # Ellenőrizze, hogy a szerver hibák nélkül indul-e node server.js # Ellenőrizze, hogy a szerver hibák nélkül elindul-e
``` ```
### Általános tesztelési megközelítés ### Általános tesztelési megközelítés
- Ez egy oktatási tárhely, nem tartalmaz teljes körű automatizált teszteket - Ez egy oktatási tárhely átfogó automatizált tesztek nélkül
- Kézi tesztelés fókuszpontjai: - Manuális tesztelés a következőkre fókuszál:
- A kódpéldák futnak hiba nélkül - Kód példák hibamentes futtatása
- A dokumentációban lévő linkek működnek - Dokumentációban lévő linkek helyes működése
- A projekt build sikeres - Projektek sikeres buildelése
- A példák követik a legjobb gyakorlatokat - Példák legjobb gyakorlati elvek szerinti követése
### Beküldés előtti ellenőrzések ### Benyújtás előtti ellenőrzések
- Futtasd az `npm run lint` parancsot a package.json-t tartalmazó könyvtárakban - Futtassuk az `npm run lint` parancsot azokban a könyvtárakban, ahol van package.json
- Ellenőrizd a markdown linkek érvényességét - Ellenőrizzük a markdown linkek érvényességét
- Teszteld a kódpéldákat böngészőben vagy Node.js alatt - Teszteljük 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 - Ellenőrizzük, hogy a fordítások megőrzik a helyes struktúrát
## Kódstílus útmutató ## Kódstílus irányelvek
### JavaScript ### JavaScript
- Használd a modern ES6+ szintaxist - Használj modern ES6+ szintaxist
- Kövesd a projektekben adott standard ESLint konfigurációkat - Kövesd a projektekben megadott ESLint konfigurációkat
- Használj jelentésgazdag változó- és függvényneveket oktatási tisztaság érdekében - Használj érthető változó- és függvénynév- megnevezéseket a tanulási cél érdekében
- Kommentáld a kódot a tanulók számára - Adj hozzászólásokat a fogalmak magyarázatához
- Formázd a kódot Prettier-rel ahol be van állítva - Használj Prettier-t a formázáshoz ahol konfigurálva van
### HTML/CSS ### HTML/CSS
- Szémantikus HTML5 elemek - Szemantikus HTML5 elemek
- Reszponzív dizájn elvek - Reszponzív tervezési elvek
- Egyértelmű osztálynevezések - Egyértelmű osztálynevek használata
- Kommentáld a CSS technikákat a tanulók számára - Kommentárok magyarázzák a CSS technikákat a tanulók számára
### Python ### Python
- Kövesd a PEP 8 stílus útmutatót - PEP 8 stílusirányelvek
- Egyértelmű, oktatási kódpéldák - Tiszta, oktatási célú kód példák
- Használj típusjelöléseket, ha segítséget nyújt a tanulásban - Típus annotációk, ahol hasznos a tanuláshoz
### Markdown dokumentáció ### Markdown dokumentáció
- Tiszta fejléc hierarchia - Tiszta címsor hierarchia
- Kódblokkok nyelvi megjelöléssel - Kódblokkok nyelvi megjelöléssel
- Linkek további erőforrásokhoz - Hivatkozások további erő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
- Alternatív szöveg a képekhez az akadálymentesség érdekében - Alt szövegek a képekhez az akadálymentesség érdekében
### Fájlok szervezése ### Fájl szervezés
- A leckék sorban számozva (1-getting-started-lessons, 2-js-basics stb.) - A leckék számozva, sorban (1-getting-started-lessons, 2-js-basics, stb.)
- Minden projektnek van `solution/` és gyakran `start/` vagy `your-work/` könyvtára - Minden projekt tartalmaz `solution/` és gyakran `start/` vagy `your-work/` mappákat
- Képek lecke specifikus `images/` mappákban tárolva - Képek a lecke specifikus `images/` mappákban tárolva
- Fordítások a `translations/{language-code}/` struktúrában - Fordítások `translations/{language-code}/` struktúrában találhatók
## Build és telepítés ## 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 Azure Static Web Apps telepítésre: A quiz-app konfigurálva van Azure Static Web Apps telepítésére:
```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
# Telepítés GitHub Actions munkafolyamat révén a main ágba történő push esetén # Közzéteszi a GitHub Actions munkafolyamattal push esetén a main ágra
``` ```
Azure Static Web Apps konfiguráció: Azure Static Web Apps beállítás:
- **App helye**: `/quiz-app` - **App hely**: `/quiz-app`
- **Kimeneti hely**: `dist` - **Kimeneti mappa**: `dist`
- **Munkafolyamat**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` - **Munkafolyamat**: `.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 # Telepítse a docsify-to-pdf csomagot npm install # docsify-to-pdf telepítése
npm run convert # PDF generálása a docs-ból npm run convert # PDF generálása a 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 # Telepítsd a Docsify-t globálisan
docsify serve # Szolgáljon a localhost:3000 címen docsify serve # Szolgáltasd a localhost:3000 címen
``` ```
### Projektspecifikus build folyamatok ### Projekt-specifikus buildelések
Minden projekt könyvtárnak saját build folyamata lehet: Minden projekt könyvtár saját build folyamatot tartalmazhat:
- Vue projektek: `npm run build`, amely létrehozza a produkciós csomagokat - Vue projektek: `npm run build` létrehozza a gyártási csomagokat
- Statikus projektek: nincs build lépés, a fájlokat közvetlenül szolgálják ki - Statikus projektek: nincs build lépés, fájlok közvetlen kiszolgálása
## Pull Request irányelvek ## Pull Request irányelvek
### Cím formátum ### Cím formátuma
Használj tiszta, leíró címeket, amelyek jelzik a változtatás területét: Használjunk világos, leíró címeket, amelyek jelzik a változtatás területét:
- `[Quiz-app] Új kvíz hozzáadása az X. leckéhez` - `[Quiz-app] Új lecke kvíz hozzáadása X`
- `[Lesson-3] Hibajavítás a terrárium projektben` - `[Lesson-3] Elírás javítása a terrárium projektben`
- `[Translation] Spanyol fordítás hozzáadása az 5. leckéhez` - `[Translation] Spanyol fordítás hozzáadása az 5. leckéhez`
- `[Docs] Beállítási utasítások frissítése` - `[Docs] Frissített beállítási utasítások`
### Kötelező ellenőrzések ### Kötelező ellenőrzések
Pull request beküldése előtt: PR benyújtása előtt:
1. **Kódminőség**: 1. **Kódminőség**:
- Futtasd az `npm run lint` parancsot az érintett projektek könyvtáraiban - Futtassuk az `npm run lint` parancsot az érintett projekt könyvtárakban
- Javíts minden lint hibát és figyelmeztetést - Javítsuk az összes lint hibát és figyelmeztetést
2. **Build ellenőrzés**: 2. **Build ellenőrzés**:
- Futtasd az `npm run build` parancsot ha szükséges - Futtassuk az `npm run build` parancsot, ha alkalmazható
- Bizonyosodj meg, hogy nincs build hiba - Biztosítsuk, hogy ne legyen build hiba
3. **Link validáció**: 3. **Linkek érvényessége**:
- Teszteld az összes markdown linket - Teszteljük az összes markdown linket
- Ellenőrizd a kép hivatkozásokat - Ellenőrizzük a kép hivatkozások működését
4. **Tartalom átvizsgálás**: 4. **Tartalom felülvizsgálat**:
- Ellenőrizd a helyesírást és nyelvtant - Ellenőrizzük helyesírást és nyelvtant
- Győződj meg róla, hogy a kódpéldák helyesek és oktatók - Győződjünk meg a kód példák helyességéről és oktató jellegéről
- Ellenőrizd, hogy a fordítások megőrzik az eredeti jelentést - Validáljuk, 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) - Elfogadás a Microsoft CLA-t (automatikus ellenőrzés az első PR-nél)
- Kövesd a [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) irányelveit - Kövessük a [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) irányelveit
- Részletes irányelvek a [CONTRIBUTING.md](./CONTRIBUTING.md) fájlban - Részletes útmutató a [CONTRIBUTING.md](./CONTRIBUTING.md) fájlban
- Hivatkozz issue számokra a PR leírásában, ha alkalmazható - Hivatkozzunk issue számokra a PR leírásában, ha vonatkozik
### Áttekintési folyamat ### Áttekintési folyamat
- PR-eket fenntartók és a közösség is átnézi - PR-eket a karbantartók és a közösség átnézi
- Oktatási érthetőség prioritás - Oktatási érthetőség elsődleges szempont
- Kódpéldák követik a jelenlegi legjobb gyakorlatokat - Kód példák kövessék a legjobb aktuális gyakorlatokat
- Fordításokat pontosság és kulturális megfelelőség szerint vizsgálják - Fordítások pontosságát és kulturális megfelelősségét ellenőrzik
## Fordítási rendszer ## Fordítási rendszer
### Automatikus fordítás ### Automatikus fordítás
- GitHub Actions-t használ co-op-translator munkafolyamattal - GitHub Actions használ co-op-translator munkafolyamatot
- Több mint 50 nyelvre fordít automatikusan - Több mint 50 nyelvre fordít automatikusan
- Forrásfájlok a fő könyvtárakban - Forrásfájlok a fő könyvtárakban vannak
- Fordított fájlok a `translations/{language-code}/` 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 ### Kézi fordítási fejlesztések hozzáadása
1. Keress rá a fájlra a `translations/{language-code}/` könyvtárban 1. Keressük meg a fájlt a `translations/{language-code}/` mappában
2. Végezd el a javításokat a struktúra megtartásával 2. Végezzük el a fejlesztéseket, megőrizve a struktúrát
3. Bizonyosodj meg róla, hogy a kódpéldák működőképesek maradnak 3. Biztosítsuk, hogy a kód példák működőképesek maradjanak
4. Teszteld a lokalizált kvíz tartalmakat 4. Teszteljük a lokalizált kvíz tartalmat
### Fordítási metaadatok ### Fordítási metaadatok
A fordított fájlok tartalmazzák a metaadat fejlécet: A fordított fájlok tartalmaznak metaadat fejlécet:
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -293,116 +293,116 @@ CO_OP_TRANSLATOR_METADATA:
### Gyakori problémák ### Gyakori problémák
**Nem indul el a quiz app**: **Kvíz alkalmazás nem indul el**:
- Ellenőrizd a Node.js verzióját (ajánlott v14+) - Ellenőrizzük a Node.js verziót (v14+ ajánlott)
- Töröld a `node_modules` és `package-lock.json` fájlokat, majd futtasd újra az `npm install` parancsot - Töröljük a `node_modules` és `package-lock.json` fájlokat, majd futtassuk újra az `npm install`-t
- Ellenőrizd a port ütközéseket (alapértelmezett: Vite a 5173-as portot használja) - Ellenőrizzük, hogy nincs-e port konfliktus (alapértelmezett: Vite a 5173-as portot használja)
**API szerver nem indul**: **API szerver nem indul**:
- Győződj meg arról, hogy a Node.js verzió >=10 - Győződjünk meg, hogy a Node.js verzió megfelel (node >=10)
- Nézd meg, hogy a port nincs foglalva - Ellenőrizzük, nincs-e használatban a port
- Ellenőrizd, hogy minden függőség fel van telepítve az `npm install`-lal - Biztosítsuk, hogy minden függőség telepítve van az `npm install` lefuttatásával
**Böngészőbővítmény nem töltődik be**: **Böngésző kiterjesztés nem töltődik be**:
- Ellenőrizd a manifest.json helyes formázását - Ellenőrizzük a manifest.json helyes formátumát
- Nézd meg a böngésző konzolt hibák után - Nézzük meg a böngésző konzolt hibákért
- Kövesd a böngésző specifikus bővítmény telepítési útmutatót - Kövessük a böngésző-specifikus kiterjesztés telepítési utasításait
**Python chat projekt problémák**: **Python chat projekt problémák**:
- Győződj meg arról, hogy az OpenAI csomag telepítve van: `pip install openai` - Győződjünk meg, hogy az OpenAI csomag telepítve van: `pip install openai`
- Ellenőrizd a GITHUB_TOKEN környezeti változó meglétét - Ellenőrizzük a GITHUB_TOKEN környezeti változó beállítását
- Nézd meg a GitHub Modellekhez való hozzáférést - Nézzük meg a GitHub Modellek elérési engedélyeit
**Docsify nem szolgálja ki a dokumentációt**: **Docsify nem szolgál ki dokumentációt**:
- Telepítsd globálisan a docsify-cli-t: `npm install -g docsify-cli` - Telepítsük globálisan a docsify-cli-t: `npm install -g docsify-cli`
- Futtasd a tárhely gyökérkönyvtárából - Futassuk a repository gyökérkönyvtárából
- Ellenőrizd, hogy a `docs/_sidebar.md` fájl létezik - Ellenőrizzük, hogy létezik-e a `docs/_sidebar.md`
### Fejlesztési környezet tippek ### Fejlesztői környezet tippek
- Használd a VS Code Live Server kiterjesztését HTML projektekhez - Használjuk a VS Code-ot Live Server bővítménnyel HTML projektekhez
- Telepítsd az ESLint és Prettier kiterjesztéseket a konzisztens formázáshoz - Telepítsük az ESLint és Prettier bővítményeket az egységes formázáshoz
- Használd a böngésző DevTools-t JavaScript hibakereséshez - Használjuk a böngésző fejlesztői eszközeit JavaScript hibakereséshez
- Vue projektekhez telepítsd a Vue DevTools böngésző kiterjesztést - Vue projektekhez telepítsük a Vue DevTools böngésző bővítményt
### Teljesítmény szempontok ### Teljesítmény szempontok
- Nagyszámú 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ón nagy méretű
- Használj shallow klónt, ha csak tartalmon dolgozol: `git clone --depth 1` - Használjuk a sekély klónozást, ha csak tartalmon dolgozunk: `git clone --depth 1`
- A keresésekből zárd ki a fordításokat, ha angol tartalmon dolgozol - Kizárhatjuk a fordításokat a keresésekből, ha csak angol tartalmat dolgozunk
- Az első futtatáskor (npm install, Vite build) a build folyamatok lassúak lehetnek - Build folyamatok lassúak lehetnek első futtatáskor (npm install, Vite build)
## Biztonsági szempontok ## Biztonsági megfontolások
### Környezeti változók ### Környezeti változók
- API kulcsok soha ne kerüljenek a tárhelyre commitálásra - API kulcsokat soha ne tegyünk be a tárhelybe
- Használj `.env` fájlokat (már a `.gitignore`-ban szerepelnek) - Használjunk `.env` fájlokat (már benne vannak `.gitignore`-ban)
- Dokumentáld a szükséges környezeti változókat a projekt README-jeiben - Dokumentáljuk a szükséges környezeti változókat a projekt README-kben
### Python projektek ### Python projektek
- Használj virtuális környezeteket: `python -m venv venv` - Virtuális környezet használata: `python -m venv venv`
- Tartsd naprakészen a függőségeket - Függőségek naprakészen tartása
- A GitHub tokeneknek minimális jogosultságokkal kell rendelkezniük - GitHub tokenek minimális szükséges jogosultsággal
### GitHub Modellekhez való hozzáférés ### GitHub Modellek elérés
- Személyes hozzáférési tokenek (PAT) szükségesek a GitHub Modellekhez - Személyes hozzáférési tokeneket (PAT) igényel a GitHub Modellek használata
- A tokeneket környezeti változóként kell tárolni - A tokeneket környezeti változóként kell tárolni
- Tokeneket és hitelesítő adatokat soha ne commitálj - Soha ne kerüljön be token vagy hitelesítő adat a forrásba
## Egyéb megjegyzések ## További megjegyzések
### Célközönség ### Célközönség
- Teljesen kezdők a webfejlesztésben - Teljesen kezdők a webfejlesztésben
- Diákok és önálló tanulók - Diákok és önálló tanulók
- Tanárok, akik az oktatási anyagot osztályteremben használják - Tanárok, akik az oktatási anyagot osztályokban használják
- A tartalom akadálymentes és fokozatos készségfejlesztésre tervezett - A tartalom akadálymentesített és fokozatos képességfejlesztésre tervezett
### Oktatási filozófia ### Oktatási filozófia
- Projekt alapú tanulás - Projektalapú tanulási módszer
- Gyakori tudásellenőrzések (kvízek) - Gyakori tudásellenőrzések (kvízek)
- Gyakorlati kódolási feladatok - Gyakorlati kódolási feladatok
- Valós alkalmazási példák - Valós példák alkalmazása
- Alapok előtérbe helyezése a keretrendszerek előtt - Az alapokra fókuszál a keretrendszerek előtt
### Tárhely karbantartás ### Tárhely karbantartás
- Aktív közösség tanulókkal és hozzájárulókkal - Aktív tanuló és hozzájáruló közösség
- Rendszeres frissítések függőségekben és tartalomban - Függőségek és tartalom rendszeres frissítése
- Az issue-k és viták fenntartók által monitorozva - Issue-k és megbeszélések folyamatos követése a karbantartók által
- Fordítások automatikusan frissülnek GitHub Actions segítségével - Fordítás frissítések automatizáltan GitHub Actions segítségével
### Kapcsolódó erő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 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 tanulóknak
- Egyéb kurzusok: Generatív AI, Adattudomány, ML, IoT tananyagok elérhetőek - Egyéb kurzusok: Generatív AI, Adattudomány, ML, IoT tananyagok elérhetők
### Egyedi projektek kezelése ### Specifikus projektek kezelése
Az egyes projektek részletes útmutatói elérhetőek a README fájlokban: Részletes utasítások az egyes projektekhez a README fájlokban:
- `quiz-app/README.md` - Vue 3 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` - Bank 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ő kiterjesztés fejlesztés
- `6-space-game/README.md` - Canvas alapú játék fejlesztés - `6-space-game/README.md` - Vászon alapú játék fejlesztés
- `9-chat-project/README.md` - AI chat asszisztens projekt - `9-chat-project/README.md` - AI chat asszisztens projekt
### Monorepo szerkezet ### Monorepo struktúra
Habár nem egy hagyományos monorepo, ez a tárhely több önálló projektet tartalmaz: Habár nem hagyományos monorepo, ez a tárhely több önálló projektet tartalmaz:
- Minden lecke önállóan működik - Minden lecke önálló
- A projektek nem osztanak meg függőségeket - Projektek nem osztanak meg függőségeket
- Az egyes projekteken önállóan dolgozhatsz befolyás nélkül a többire - Egyedi projektek fejlesztése anélkül, hogy másokat befolyásolnánk
- A teljes tananyag élményért klónozd a teljes tárhelyet - Teljes tanterv élményéhez a teljes tárhely klónozása ajánlott
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Felelősség kizárása**: **Nyilatkozat**:
Ez a dokumentum az AI fordító szolgáltatás [Co-op Translator](https://github.com/Azure/co-op-translator) segítségével készült. Bár az pontosságra törekszünk, kérjük, vegye figyelembe, hogy az automatikus fordítás hibákat vagy pontatlanságokat tartalmazhat. Az eredeti dokumentum a saját nyelvén tekintendő hiteles forrásnak. Kritikus információk esetén professzionális 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 téves értelmezésekért. 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 törekszünk a pontosságra, kérjük, vegye figyelembe, hogy az automatikus fordítások hibákat vagy pontatlanságokat tartalmazhatnak. Az eredeti dokumentum az anyanyelvén tekintendő hiteles forrásnak. Kritikus információk esetén javasolt a professzionális emberi fordítás. Nem vállalunk felelősséget ezen fordítás használatából eredő félreértésekért vagy félreértelmezésekért.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T15:50:02+00:00", "translation_date": "2026-04-20T16:53:47+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "sw" "language_code": "sw"
}, },

@ -2,36 +2,36 @@
## Muhtasari wa Mradi ## Muhtasari wa Mradi
Huu ni hifadhidata ya mtaala wa elimu kwa kufundisha misingi ya maendeleo ya wavuti kwa wanaoanza. Mtaala ni kozi kamili ya wiki 12 iliyotengenezwa na Microsoft Cloud Advocates, ikijumuisha masomo 24 ya vitendo kuhusu JavaScript, CSS, na HTML. Huu ni hazina ya mtaala wa elimu kwa ajili ya kufundisha misingi ya maendeleo ya wavuti kwa wanaoanza. Mtaala ni kozi kamili ya wiki 12 iliyotengenezwa na Microsoft Cloud Advocates, ikiwa na masomo 24 ya vitendo yanayohusu JavaScript, CSS, na HTML.
### Vipengele Muhimu ### Vipengele Muhimu
- **Maudhui ya Elimu**: Masomo 24 yaliyopangiliwa kwa muundo wa moduli zinazotegemea miradi - **Yaliyomo ya Elimu**: Masomo 24 yaliyopangwa kwa muundo wa moduli za miradi
- **Miradi ya Vitendo**: Terrarium, Mchezo wa Uandikaji, Kiongezi cha Kivinjari, Mchezo wa Anga, App ya Benki, Mhariri wa Nambari, na Msaidizi wa Mazungumzo wa AI - **Miradi ya Vitendo**: Terrarium, Mchezo wa Kuandika, Upanuzi wa Kivinjari, Mchezo wa Anga, Programu ya Benki, Mhariri wa Msimbo, na Msaidizi wa AI wa Mazungumzo
- **Mitihani ya Kuingiliana**: Mitihani 48 yenye maswali 3 kila moja (mapema/kwa baada ya somo) - **Maswali Shindani Ya Kihusianisho**: Maswali 48 kila moja ikiwa na maswali 3 (majaribio kabla/baada ya somo)
- **Usaidi wa Lugha Nyingi**: Tafsiri za moja kwa moja kwa lugha zaidi ya 50 kupitia GitHub Actions - **Msaada wa Lugha Nyingi**: Tafsiri za moja kwa moja za lugha zaidi ya 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 ### Miundo-Mbinu
- Hifadhidata ya elimu yenye muundo wa somo kwa somo - Hazina ya elimu yenye muundo wa masomo
- Kila folda ya somo ina README, mifano ya nambari, na suluhisho - Kila folda ya somo ina README, mifano ya msimbo, na suluhisho
- Miradi huru katika saraka tofauti (quiz-app, miradi mbalimbali ya somo) - Miradi huru katika saraka tofauti (quiz-app, miradi mbalimbali ya masomo)
- Mfumo wa tafsiri ukitumia GitHub Actions (co-op-translator) - Mfumo wa tafsiri ukitumia GitHub Actions (co-op-translator)
- Nyaraka zinatolewa kupitia Docsify na zinapatikana kama PDF - Nyaraka zinatolewa kupitia Docsify na zinapatikana kama PDF
## Amri za Usanidi ## Amri za Kuanzisha
Hifadhidata hii ni hasa kwa matumizi ya maudhui ya kielimu. Kwa kufanya kazi na miradi maalum: Hazina hii ni hasa kwa kutumia yaliyomo ya elimu. Kwa kufanya kazi na miradi maalum:
### Usanidi Mkuu wa Hifadhidata ### Kuanzisha 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
``` ```
### Usanidi wa Quiz App (Vue 3 + Vite) ### Kuanzisha Quiz App (Vue 3 + Vite)
```bash ```bash
cd quiz-app cd quiz-app
@ -48,15 +48,15 @@ cd 7-bank-project/api
npm install npm install
npm start # Anzisha seva ya API npm start # Anzisha seva ya API
npm run lint # Endesha ESLint npm run lint # Endesha ESLint
npm run format # Panga kwa kutumia Prettier npm run format # Pangilia kwa Prettier
``` ```
### Miradi ya Kiongezi cha Kivinjari ### Miradi ya Upanuzi wa Kivinjari
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
npm install npm install
# Fuata maelekezo ya kupakia ugani kwa kivinjari maalum # Fuata maagizo ya kupakia upanuzi maalum kwa kivinjari
``` ```
### Miradi ya Mchezo wa Anga ### Miradi ya Mchezo wa Anga
@ -72,128 +72,128 @@ npm install
```bash ```bash
cd 9-chat-project/solution/backend/python cd 9-chat-project/solution/backend/python
pip install openai pip install openai
# Weka mazingira ya mabadiliko ya GITHUB_TOKEN # Weka kigezo cha mazingira cha GITHUB_TOKEN
python api.py python api.py
``` ```
## Mtiririko wa Maendeleo ## Mtiririko wa Maendeleo
### Kwa Wachangiaji wa Maudhui ### Kwa Wasaidizi wa Yaliyomo
1. **Fungua hifadhidata** kwenye akaunti yako ya GitHub 1. **Fungua hazina kwa fork** kwa akaunti yako ya GitHub
2. **Dondoa hifadhidata hii** mahali pako pa kazi 2. **Nakili fork yako** mahali hapo ndani
3. **Tengeneza tawi jipya** kwa mabadiliko yako 3. **Tengeneza tawi jipya** kwa mabadiliko yako
4. Fanya mabadiliko kwenye maudhui ya somo au mifano ya nambari 4. Fanya mabadiliko kwenye yaliyomo ya masomo au mifano ya msimbo
5. Jaribu mabadiliko ya nambari katika saraka za miradi husika 5. Jaribu mabadiliko yoyote ya msimbo katika saraka za miradi husika
6. Tuma ombi la mvutano kwa kufuata miongozo ya mchango 6. Wasilisha rufaa za kuchukua mabadiliko kuzingatia miongozo ya mchango
### Kwa Wanafunzi ### Kwa Wanafunzi
1. Fungua au dondoa hifadhidata 1. Funga au nakili hazina
2. Pitia saraka za masomo kwa mpangilio 2. Elekea kwenye saraka za masomo kwa mpangilio
3. Soma mafaili ya README kwa kila somo 3. Soma faili za README kwa kila somo
4. Maliza mitihani ya kabla ya somo kwenye https://ff-quizzes.netlify.app/web/ 4. Maliza maswali ya kabla ya somo huko https://ff-quizzes.netlify.app/web/
5. Fanya kazi kwa mfano wa nambari katika folda za somo 5. Fanyia kazi mifano ya msimbo katika folda za masomo
6. Maliza kazi na changamoto 6. Maliza kazi za nyumbani na changamoto
7. Fanya mitihani ya baada ya somo 7. Fanya maswali ya baada ya somo
### Maendeleo Unaioishi ### Maendeleo Hai
- **Nyaraka**: Endesha `docsify serve` katika saraka kuu (bandari 3000) - **Nyaraka**: Endesha `docsify serve` kwenye saraka ya juu (bandari 3000)
- **Quiz App**: Endesha `npm run dev` katika saraka 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 upanuzi wa VS Code Live Server kwa miradi ya HTML
- **Miradi ya API**: Endesha `npm start` katika saraka husika za API - **Miradi ya API**: Endesha `npm start` katika saraka husika za API
## Maelekezo ya Kupima ## Maelekezo ya Kupima
### Upimaji wa Quiz App ### Kupima Quiz App
```bash ```bash
cd quiz-app cd quiz-app
npm run lint # Angalia matatizo ya mtindo wa msimbo npm run lint # Angalia kwa matatizo ya mtindo wa msimbo
npm run build # Thibitisha ujenzi unafanikiwa npm run build # Thibitisha ujenzi unafanikiwa
``` ```
### Upimaji wa Bank API ### Kupima API ya Benki
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm run lint # Angalia masuala ya mtindo wa msimbo npm run lint # Angalia kwa masuala ya mtindo wa msimbo
node server.js # Thibitisha seva inaanza bila makosa node server.js # Thibitisha seva inaanza bila makosa
``` ```
### Mbinu ya Upimaji kwa Jumla ### Mbinu ya Kupima kwa Ujumla
- Hii ni hifadhidata ya elimu isiyo na majaribio ya moja kwa moja ya kina - Hii ni hazina ya elimu isiyo na majaribio ya moja kwa moja ya kina
- Upimaji wa mikono unalenga: - Kupima kwa mikono kunalenga:
- Mifano ya nambari iaendeshwe bila makosa - Mifano ya msimbo inakimbia bila makosa
- Viungo katika nyaraka vifanye kazi kwa usahihi - Viungo vya nyaraka vinafanya kazi kikamilifu
- Ujenzi wa mradi ukamilike kwa mafanikio - Miradi kujengwa kikamilifu bila hitilafu
- Mifano ifuatilie mbinu bora - Mifano inafuata mbinu bora
### Ukaguzi wa Kabla ya Kuwasilisha ### Ukaguzi Kabla ya Kuwasilisha
- Endesha `npm run lint` katika saraka zenye package.json - Endesha `npm run lint` katika saraka zilizo na package.json
- Hakiki viungo vya markdown viko sahihi - Hakiki viungo vya markdown vipate usahihi
- Jaribu mifano ya nambari kwenye kivinjari au Node.js - Jaribu mifano ya msimbo kwenye kivinjari au Node.js
- Hakiki tafsiri zihakikishe muundo unahifadhiwa - Hakikisha tafsiri zinahifadhi muundo sahihi
## Miongozo ya Mtindo wa Msimbo ## Miongozo ya Mtindo wa Msimbo
### JavaScript ### JavaScript
- Tumia msimbo wa kisasa wa ES6+ - Tumia lugha ya kisasa ya ES6+
- Fuata mipangilio ya ESLint inayotolewa katika miradi - Fuata mipangilio ya kawaida ya ESLint iliyopo katika miradi
- Tumia majina ya maana kwa vigezo na kazi kwa uwazi wa kielimu - Tumia majina yenye maana kwa mabadiliko na kazi kwa ajili ya ufafanuzi wa elimu
- Ongeza maelezo kuelezea dhana kwa wanafunzi - Ongeza maelezo kuelezea dhana kwa wanafunzi
- Tumia Prettier kwa uundaji ikiwa imewekwa - Tengeneza kwa kutumia Prettier pale panapopangwa
### HTML/CSS ### HTML/CSS
- Vipengele vya semantic vya HTML5 - Vipengele vya semantic vya HTML5
- Misingi ya muundo wa kujibadilisha (responsive) - Kanuni za muundo wa kujibadilisha (responsive)
- Miundo ya majina ya darasa wazi - Viwango vya uandishi vya darasa wazi
- Maelezo yanayoelezea mbinu za CSS kwa wanafunzi - Maelezo kuelezea mbinu za CSS kwa wanafunzi
### Python ### Python
- Miongozo ya mtindo wa PEP 8 - Miongozo ya mtindo ya PEP 8
- Mifano ya nambari wazi, ya kielimu - Mifano ya msimbo wazi, ya elimu
- Maelezo ya aina pale yanaposaidia kujifunza - Vidokezo vya aina inapobidi kwa kujifunza
### Nyaraka za Markdown ### Nyaraka za Markdown
- Muundo wazi wa vichwa - Muundo wa vichwa vya habari kwa uwazi
- Vizuizi vya msimbo na maelezo ya lugha - Mifumo ya msimbo yenye lugha maalum
- Viungo vya rasilimali za ziada - Viungo kwenye rasilimali za ziada
- Picha za skrini na picha katika saraka `images/` - Picha na picha ndogo katika saraka za `images/`
- Maandishi ya alt kwa picha kwa upatikanaji - Maandishi ya alt ya picha kwa upatikanaji
### Mpangilio wa Faili ### Mpangilio wa Faili
- Masomo yametambuliwa kwa mfuatano (1-getting-started-lessons, 2-js-basics, nk) - Masomo yamenumberwa kwa mfuatano (1-getting-started-lessons, 2-js-basics, nk)
- Kila mradi una saraka za `solution/` na mara nyingi `start/` au `your-work/` - Kila mradi una saraka za `solution/` na mara nyingi `start/` au `your-work/`
- Picha zinahifadhiwa katika saraka maalum za `images/` kwa somo - Picha zimehifadhiwa katika saraka maalum za masomo `images/`
- Tafsiri ziko katika muundo wa `translations/{language-code}/` - Tafsiri ziko katika muundo wa `translations/{language-code}/`
## Ujenzi na Utoaji ## Ujenzi na Uenezaji
### Utoaji wa Quiz App (Azure Static Web Apps) ### Uenezaji wa Quiz App (Azure Static Web Apps)
quiz-app imewekwa kwa ajili ya utoaji wa Azure Static Web Apps: Quiz-app imewekwa kwa ajili ya uenezaji wa 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/
# Inaweka kupitia mtiririko wa kazi wa GitHub Actions wakati wa kusukuma kwenye main # Inaendesha kupitia mtiririko wa kazi wa GitHub Actions wakati wa kusukuma kwenye main
``` ```
Usanidi wa Azure Static Web Apps: Mipangilio ya Azure Static Web Apps:
- **Mahali pa app**: `/quiz-app` - **Eneo la app**: `/quiz-app`
- **Mahali pa pato**: `dist` - **Eneo la matokeo**: `dist`
- **Mtiririko wa kazi**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` - **Mtiririko wa kazi**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Uzalishaji PDF wa Nyaraka ### Uzalishaji 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 # Install Docsify ulimwenguni kote npm install -g docsify-cli # Sakinisha Docsify kote duniani
docsify serve # Hudumia kwenye localhost:3000 docsify serve # Tumikia kwenye localhost:3000
``` ```
### Ujenzi Maalum wa Miradi ### Ujenzi wa Miradi Maalum
Kila saraka ya mradi inaweza kuwa na mchakato wake wa ujenzi: Kila saraka ya mradi inaweza kuwa na mchakato wake wa ujenzi:
- Miradi ya Vue: `npm run build` hutengeneza vifurushi vya uzalishaji - Miradi ya Vue: `npm run build` huunda vifurushi vya uzalishaji
- Miradi ya static: Hakuna hatua ya ujenzi, hudumu faili moja kwa moja - Miradi isiyohitaji ujenzi: Hakuna hatua ya ujenzi, hudumisha faili moja kwa moja
## Miongozo ya Ombi la Mvutano ## Miongozo ya Rufaa za Kuchukua Mabadiliko (Pull Requests)
### Muundo wa Kichwa ### Muundo wa Kichwa
Tumia vichwa vya wazi vinavyoelezea eneo la mabadiliko: Tumia vichwa wazi, vinavyoelezea maeneo ya mabadiliko:
- `[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 tahajia katika mradi wa terrarium`
- `[Translation] Ongeza tafsiri ya Kihispania kwa somo 5` - `[Translation] Ongeza tafsiri ya Kihispania kwa somo 5`
- `[Docs] Sasisha maelekezo ya usanidi` - `[Docs] Sasisha maelekezo ya kuanzisha`
### Ukaguzi unaohitajika ### Vyakati Vinavyohitajika
Kabla ya kuwasilisha ombi: Kabla ya kuwasilisha PR:
1. **Ubora wa Msimbo**: 1. **Ubora wa Msimbo**:
- Endesha `npm run lint` katika saraka za mradi zilizoathirika - Endesha `npm run lint` katika saraka zilizoathirika
- Rekebisha makosa na tahadhari zote za lint - Rekebisha makosa na onyo zote za lint
2. **Uhakiki wa Ujenzi**: 2. **Uhakiki wa Ujenzi**:
- Endesha `npm run build` ikiwa inahitajika - Endesha `npm run build` inapohitajika
- Hakikisha hakuna makosa ya ujenzi - Hakikisha hakuna makosa ya ujenzi
3. **Uhakiki wa Viungo**: 3. **Uhakiki wa Viungo**:
- Jaribu viungo vyote vya markdown - Jaribu viungo vyote vya markdown
- Hakiki marejeo ya picha yanafanya kazi - Thibitisha marejeo ya picha zinafanya kazi
4. **Ukaguzi wa Maudhui**: 4. **Ukaguzi wa Yaliyomo**:
- Soma tena kwa tahajia na sarufi - Soma kwa makini kwa makosa ya tahajia na sarufi
- Hakikisha mifano ya nambari ni sahihi na ya kielimu - Hakikisha mifano ya msimbo ni sahihi na ya kielimu
- Hakiki tafsiri zihakikishe maana asili inahifadhiwa - Hakikisha tafsiri zinahifadhi maana asilia
### Mahitaji ya Mchango ### Masharti ya Michango
- Kubali Microsoft CLA (ukaguzi wa moja kwa moja kwenye PR ya kwanza) - Kubali Microsoft CLA (ukaguzi wa moja kwa moja kwa PR ya kwanza)
- Fuata [Kanuni ya Maadili ya Chanzo Huria ya Microsoft](https://opensource.microsoft.com/codeofconduct/) - Fuata [Sheria za Maadili za Chanzo Huria za Microsoft](https://opensource.microsoft.com/codeofconduct/)
- Tazama [CONTRIBUTING.md](./CONTRIBUTING.md) kwa miongozo ya kina - Angalia [CONTRIBUTING.md](./CONTRIBUTING.md) kwa miongozo ya kina
- Taja nambari za masuala katika maelezo ya PR ikiwa zinahusika - Taja nambari za masuala katika maelezo ya PR inapowezekana
### Mchakato wa Mapitio ### Mchakato wa Ukaguzi
- PR hupitiwa na watunza na jamii - PR hurejelewa na waendelezaji na jamii
- Uwiano wa elimu unapewa kipaumbele - Uwazi wa elimu unaangaziwa
- Mifano ya nambari ifuatilie mbinu bora za sasa - Mifano ya msimbo inapaswa kufuata mbinu bora za sasa
- Tafsiri hupitiwa kwa usahihi na ulinganishaji wa kitamaduni - Tafsiri hurejelewa kwa usahihi na utamaduni unaofaa
## Mfumo wa Tafsiri ## Mfumo wa Tafsiri
### Tafsiri ya Moja kwa Moja ### Tafsiri ya Moja kwa Moja (Automated)
- Inatumia GitHub Actions na mtiririko wa co-op-translator - Inatumia GitHub Actions na mtiririko wa co-op-translator
- Hutoa tafsiri za lugha zaidi ya 50 moja kwa moja - Inatafsiri hadi lugha zaidi ya 50 moja kwa moja
- Faili za chanzo ziko katika saraka kuu - Faili za chanzo ziko katika saraka kuu
- Faili zilizotafsiriwa ziko katika saraka `translations/{language-code}/` - Faili za tafsiri ziko katika saraka za `translations/{language-code}/`
### Kuongeza Maboresho ya Tafsiri ya Mikono ### Kuongeza Maboresho ya Tafsiri Kwa Mkono
1. Tafuta faili katika `translations/{language-code}/` 1. Tafuta faili katika `translations/{language-code}/`
2. Fanya maboresho huku ukihifadhi muundo 2. Fanya maboresho huku ukihifadhi muundo
3. Hakikisha mifano ya nambari inaendelea kufanya kazi 3. Hakikisha mifano ya msimbo inabaki kutumika
4. Jaribu maudhui ya mitihani ya eneo waliloitafsiriwa 4. Jaribu yaliyomo ya mitihani iliyotafsiriwa
### Meta-data ya Tafsiri ### Metadata ya Tafsiri
Faili zilizotafsiriwa zina kichwa cha metadata: Faili za tafsiri zina kichwa cha metadata:
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
--> -->
``` ```
## Utafutaji na Utatuzi wa Matatizo ## Kurekebisha na Kutatua Matatizo
### Masuala ya Kawaida ### Changamoto Zaidi Zaidi
**App ya quiz haianzi**: **App ya Quiz haianzi**:
- Angalia toleo la Node.js (v14+ inapendekezwa) - Hakiki toleo la Node.js (inashauriwa v14+)
- Futa `node_modules` na `package-lock.json`, endesha `npm install` tena - Futa `node_modules` na `package-lock.json`, endesha tena `npm install`
- Hakiki mgongano wa bandari (kawaida: Vite hutumia bandari 5173) - Angalia migongano ya bandari (kawaida: Vite hutumia bandari 5173)
**Server ya API haishi**: **Server ya API haianzi**:
- Thibitisha toleo la Node.js linakidhi minimum (node >=10) - Hakiki toleo la Node.js linakidhi (node >=10)
- Angalia ikiwa bandari imeshatumika tayari - Angalia kama bandari tayari inatumika
- Hakikisha tegemezi zote zimewekwa kwa `npm install` - Hakikisha utegemezi wote umetolewa kwa `npm install`
**Kiongezi cha kivinjari hakianzi**: **Upanuzi wa kivinjari hauanziki**:
- Hakiki kuwa manifest.json imepangwa kwa usahihi - Hakiki manifest.json imepandishwa vema
- Angalia console ya kivinjari kwa makosa - Angalia console ya kivinjari kwa makosa
- Fuata maelekezo ya usakinishaji wa kiongezi cha kivinjari maalum - Fuata maelekezo ya usanidi wa upanuzi wa kivinjari
**Masuala ya mradi wa mazungumzo wa Python**: **Matatizo ya Mradi wa Mazungumzo wa Python**:
- Thibitisha kifurushi cha OpenAI kimesakinishwa: `pip install openai` - Hakikisha kifurushi cha OpenAI kimesakinishwa: `pip install openai`
- Hakiki mazingira ya GITHUB_TOKEN yamewekwa - Hakiki kuwa mabadiliko ya mazingira ya GITHUB_TOKEN yamewekwa
- Angalia ruhusa za GitHub Models - Hakiki vibali vya ufikiaji kwa GitHub Models
**Docsify haitumii nyaraka**: **Docsify haisikilizi nyaraka**:
- Sakinisha docsify-cli duniani: `npm install -g docsify-cli` - Sakinisha docsify-cli ulimwenguni: `npm install -g docsify-cli`
- Endesha kutoka saraka kuu ya hifadhidata - Endesha kutoka saraka kuu ya hazina
- Hakiki kuwa `docs/_sidebar.md` ipo - Hakiki `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 upanuzi wa Live Server kwa miradi ya HTML
- Sakinisha ugani za ESLint na Prettier kwa uundaji thabiti - Sakinisha upanuzi za ESLint na Prettier kwa mtindo thabiti
- Tumia DevTools za kivinjari kutatua matatizo ya JavaScript - Tumia DevTools wa kivinjari kwa kupata na kutatua makosa ya JavaScript
- Kwa miradi ya Vue, sakinisha Vue DevTools ugani wa kivinjari - Kwa miradi ya Vue, sakinisha upanuzi wa Vue DevTools kivinjari
### Masharti ya Utendaji ### Mambo ya Kujali Kuhusu Utendaji
- Idadi kubwa ya faili zilizotafsiriwa (zaidi ya 50) inasababisha vane kubwa kwa clone kamili - Idadi kubwa ya faili za tafsiri (za lugha 50+) huongeza ukubwa wa nakala kamili
- Tumia shallow clone wakati unafanya kazi tu na maudhui: `git clone --depth 1` - Tumia nakala ya chini (shallow) ikiwa unafanya kazi tu kwa yaliyomo: `git clone --depth 1`
- Epuka tafsiri wakati wa kufanya kazi na maudhui ya Kiingereza - Epuka tafutiza za tafsiri wakati unafanya kazi na yaliyomo ya Kiingereza
- Mchakato wa ujenzi unaweza kuwa polepole kwa mara ya kwanza (npm install, ujenzi wa Vite) - Mienendo ya ujenzi inaweza kuwa polepole mwanzoni (npm install, ujenzi wa Vite)
## Mambo ya Usalama ## Masuala ya Usalama
### Mabadiliko ya Mazingira ### Mabadiliko ya Mazingira
- Funguo za API hazipaswi kungolewa hifadhidatani - Funguo za API hazipaswi kuwekwa moja kwa moja katika hazina
- Tumia faili za `.env` (zipo tayari katika `.gitignore`) - Tumia faili za `.env` (zipo katika `.gitignore`)
- Andika mabadiliko ya mazingira yanayohitajika katika README za miradi - Elezea mabadiliko ya mazingira yanayohitajika katika README za miradi
### Miradi ya Python ### Miradi ya Python
- Tumia mazingira ya virtual: `python -m venv venv` - Tumia mazingira ya pekee: `python -m venv venv`
- Dumisha dependencies zikisasishwa - Sasisha utegemezi mara kwa mara
- Tokens za GitHub zisiwe na ruhusa zaidi ya zisizohitajika - Tokeni za GitHub zinapaswa kuwa na vibali vidogo vinavyotakiwa tu
### Ufikiaji wa GitHub Models ### Ufikiaji wa GitHub Models
- Tokens za Ufikiaji Binafsi (PAT) zinahitajika kwa GitHub Models - Mipangilio ya Ufikiaji wa Kibinafsi (PAT) inahitajika kwa GitHub Models
- Tokens zihifadhiwe kama mabadiliko ya mazingira - Tokeni ziwe katika mabadiliko ya mazingira
- Kamwe usiweke tokens au nyaraka za usalama hifadhidatani - Kamwe usiweka tokeni au nyaraka katika hazina
## Vidokezo Zaidi ## Vidokezo Zaidi
### Hadhira Lengwa ### Hadhira Lengwa
- Waanzilishi kabisa wa maendeleo ya wavuti - Wananchi wapya kabisa katika maendeleo ya wavuti
- Wanafunzi na wanaojifunza peke yao - Wanafunzi na waelimishaji wa kujifunza peke yao
- Walimu wanaotumia mtaala katika madarasa - Walimu wanaotumia mtaala darasani
- Maudhui yamebuniwa kwa upatikanaji na kujenga ujuzi polepole - Yaliyomo yamebuniwa kwa kupatikana na kukuza hatua kwa hatua ujuzi
### Falsafa ya Elimu ### Falsafa ya Elimu
- Mbinu ya kujifunza kwa mradi - Mbinu ya kujifunza kwa miradi
- Vipimo vya mara kwa mara vya maarifa (quiz) - Ukaguzi wa mara kwa mara wa maarifa (maswali)
- Mazoezi ya kuandika msimbo kwa mikono - Mazoezi ya kuandika msimbo kwa vitendo
- Mifano ya matumizi halisi - Mifano ya matumizi halisi ya dunia ya kweli
- Kuzingatia misingi kabla ya mifumo ya kazi - Kuzingatia misingi kabla ya mifumo ngumu
### Matunzo ya Hifadhidata ### Matengenezo ya Hazina
- Jamii hai ya wanafunzi na wachangiaji - Jamii hai ya wanafunzi na wasaidizi
- Sasisho za mara kwa mara kwa tegemezi na maudhui - Sasisho za mara kwa mara za utegemezi na yaliyomo
- Masuala na majadiliano yanatiliwa mkazo na watunza - Masuala na majadiliano yanatazamwa na watunzaji
- Sasisho za tafsiri kwa njia ya otomatiki kupitia GitHub Actions - Sasisho za tafsiri zimepangwa 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 Kitovu cha Mwanafunzi](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) inashauriwa kwa wanafunzi - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) inashauriwa kwa wanafunzi
- Kozi za ziada: AI ya kizazi, Sayansi ya Data, ML, IoT zinapatikana - Kozi zingine: AI ya kuzalisha, Sayansi ya Data, ML, na mtaala wa IoT zinapatikana
### Kufanya Kazi na Miradi Maalum ### Kufanya kazi na Miradi Mahususi
Kwa maelekezo ya kina ya miradi binafsi, rejelea mafaili ya README katika: Kwa maelekezo ya kina juu ya miradi binafsi, rejea faili za README katika:
- `quiz-app/README.md` - Programu ya kucheza quiz ya Vue 3 - `quiz-app/README.md` - Programu ya mtihani 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` - Maendeleo ya kiongezi cha kivinjari - `5-browser-extension/README.md` - Maendeleo ya upanuzi wa kivinjari
- `6-space-game/README.md` - Maendeleo ya mchezo wa Canvas - `6-space-game/README.md` - Maendeleo ya 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 kadhaa huru: Ingawa sio monorepo ya kawaida, hazina hii ina miradi huru mingi:
- Kila somo ni tegemezi la pekee - Kila somo limejitegemea
- Miradi haishiriki tegemezi - Miradi haishiriki utegemezi
- Fanya kazi kwenye miradi binafsi bila kuathiri mingine - Fanya kazi kwenye miradi binafsi bila kuathiri mingine
- Dondoa hifadhidata nzima kwa uzoefu kamili wa mtaala - Nakili hazina nzima kwa uzoefu kamili wa mtaala
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Angalizo**: **Kinyang'anyiro**:
Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI [Co-op Translator](https://github.com/Azure/co-op-translator). Wakati tunajitahidi kwa usahihi, tafadhali fahamu kwamba tafsiri za kiotomatiki zinaweza kuwa na makosa au upungufu katika usahihi. Hati ya asili katika lugha yake ya asili inapaswa kuchukuliwa kama chanzo chenye mamlaka. Kwa taarifa muhimu, tafsiri ya kitaalamu ya binadamu inapendekezwa. Hatuwajibiki kwa mkanganyiko wowote au kutoelewana kunakotokana na matumizi ya tafsiri hii. Hati hii imetafsiriwa kwa kutumia huduma ya tafsiri ya AI [Co-op Translator](https://github.com/Azure/co-op-translator). Wakati tunajitahidi kwa usahihi, tafadhali fahamu kwamba tafsiri za kiotomati zinaweza kuwa na makosa au upotoshaji. Hati ya asili katika lugha yake ya asili inapaswa kuchukuliwa kama chanzo cha mamlaka. Kwa taarifa muhimu, tafsiri ya mtaalamu wa binadamu inapendekezwa. Hatubeba jukumu la kutokea kwa kutoelewana au tafsiri potofu kutokana na matumizi ya tafsiri hii.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->
Loading…
Cancel
Save