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

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

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

@ -2,27 +2,27 @@
## 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
- **Praktické projekty**: Terrárium, Hra na psaní, Rozšíření prohlížeče, Hra ve vesmíru, Bankovní aplikace, Editor kódu a AI chatovací asistent
- **Interaktivní kvízy**: 48 kvízů se 3 otázkami každý (hodnocení před a po lekci)
- **Podpora více jazyků**: Automatické překlady pro více než 50 jazyků pomocí GitHub Actions
- **Praktické projekty**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor a AI Chat Assistant
- **Interaktivní kvízy**: 48 kvízů s 3 otázkami každý (před/po lekci)
- **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)
### 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í
- 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)
- 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í
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
@ -41,7 +41,7 @@ npm run build # Sestavit pro produkci
npm run lint # Spustit ESLint
```
### Bankovní API projekt (Node.js + Express)
### Bankovní projekt API (Node.js + Express)
```bash
cd 7-bank-project/api
@ -51,7 +51,7 @@ npm run lint # Spustit ESLint
npm run format # Formátovat pomocí Prettier
```
### Projekty rozšíření prohlížeče
### Projekty pro rozšíření prohlížeče
```bash
cd 5-browser-extension/solution
@ -67,7 +67,7 @@ npm install
# Otevřete index.html v prohlížeči nebo použijte Live Server
```
### Chatovací projekt (Python backend)
### Chat projekt (Python backend)
```bash
cd 9-chat-project/solution/backend/python
@ -80,107 +80,107 @@ python api.py
### Pro přispěvatele obsahu
1. **Rozvětvěte (fork) repozitář** do svého GitHub účtu
2. **Naklonujte svůj fork** lokálně
1. **Vytvořte fork repozitáře** do svého GitHub účtu
2. **Naklonujte svojí větev** lokálně
3. **Vytvořte novou větev** pro své změny
4. Proveďte změny v obsahu lekce nebo příkladech kódu
5. Testujte kódové změny v příslušných projektových složkách
6. Podávejte pull requesty podle pokynů pro přispě
4. Proveďte změny v obsahu lekcí nebo příkladech kódu
5. Otestujte změny v příslušných projektech
6. Odešlete pull requesty dle zásad přispívá
### Pro studenty
1. Rozvětvěte nebo naklonujte repozitář
2. Procházejte lekční složky postupně
3. Čtěte README soubory pro každou lekci
4. Dokončete předběžné kvízy na https://ff-quizzes.netlify.app/web/
5. Procházejte příklady kódu v lekčních složkách
6. Dokončete úkoly a výzvy
7. Absolvujte kvízy po lekci
1. Vytvořte fork nebo klonujte repozitář
2. Postupujte sekvenčně do adresářů lekcí
3. Čtěte README soubory každé lekce
4. Dokončete před/po- lekční kvízy na https://ff-quizzes.netlify.app/web/
5. Procvičujte si příklady kódu v adresářích lekcí
6. Plňte úkoly a výzvy
7. Absolvujte závěrečné kvízy
### Živý vývoj
- **Dokumentace**: Spusťte `docsify serve` v rootu (port 3000)
- **Quiz App**: Spusťte `npm run dev` ve složce quiz-app
- **Dokumentace**: Spusťte `docsify serve` v kořenovém adresáři (port 3000)
- **Quiz App**: Spusťte `npm run dev` v adresáři quiz-app
- **Projekty**: Použijte VS Code Live Server rozšíření pro HTML projekty
- **API projekty**: Spusťte `npm start` v příslušných API složkách
## Instrukce testování
## Testování
### Testování Quiz App
```bash
cd quiz-app
npm run lint # Zkontrolujte problémy se stylem kódu
npm run build # Ověřte, že kompilace proběhla úspěšně
npm run build # Ověřte, že sestavení proběhlo úspěšně
```
### Testování Bank API
```bash
cd 7-bank-project/api
npm run lint # Zkontrolujte problémy s stylem kódu
node server.js # Ověřte, že server startuje bez chyb
npm run lint # Zkontrolujte problémy se stylem kódu
node server.js # Ověřte, zda server startuje bez chyb
```
### 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:
- 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
- Ú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
- Ověřte platnost odkazů v markdownu
- Spusťte `npm run lint` v adreřích s package.json
- Ověřte platnost markdown odkazů
- Testujte příklady kódu v prohlížeči nebo Node.js
- Zkontrolujte, že překlady zachovávají správnou strukturu
## Zásady stylu kódu
## Směrnice pro styl kódu
### JavaScript
- Používejte moderní syntaxi ES6+
- Dodržujte standardní ESLint konfigurace v projektech
- Používejte smysluplné názvy proměnných a funkcí pro vzdělávací přehlednost
- Přidávejte komentáře vysvětlující koncepty pro studenty
- Formátujte pomocí Prettier tam, kde je nastaveno
- Používejte moderní ES6+ syntaxi
- Dodržujte standardní ESLint nastavení v projektech
- Používejte smysluplná jména proměnných a funkcí pro lepší porozumění
- Přidávejte komentáře vysvětlující pojmy pro studenty
- Formátujte kód pomocí Prettier tam, kde je nastaveno
### HTML/CSS
- Sémantické HTML5 elementy
- Semantické elementy HTML5
- Principy responzivního designu
- Jasné konvence pojmenování tříd
- Komentáře vysvětlující CSS techniky pro studenty
### Python
- Dodržování PEP 8 stylu
- Dodržujte stylové pravidla PEP 8
- 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
- Jasná hierarchie nadpisů
- Kódové bloky s určením jazyka
- Bloky kódu s určením jazyka
- Odkazy na další zdroje
- Snímky obrazovky a obrázky ve složkách `images/`
- Alt texty pro obrázky pro přístupnost
- Snímky obrazovky a obrázky ve složce `images/`
- Alt text pro obrázky pro zpřístupnění
### 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/`
- Obrázky uložené v lekčně specifických složkách `images/`
- Překlady ve struktuře `translations/{jazykový-kód}/`
- Obrázky uložené ve složkách `images/` jednotlivých lekcí
- Překlady ve struktuře `translations/{language-code}/`
## Sestavení a nasazení
## Build a nasazení
### 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
cd quiz-app
@ -190,93 +190,93 @@ npm run build # Vytváří složku dist/
Konfigurace Azure Static Web Apps:
- **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`
### Generování PDF dokumentace
```bash
npm install # Nainstalujte docsify-to-pdf
npm run convert # Vygenerujte PDF z docs
npm run convert # Vygenerujte PDF z dokumentace
```
### Docsify dokumentace
```bash
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
- 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
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`
- `[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`
- `[Docs] Aktualizovat instrukce pro nastavení`
- `[Docs] Aktualizovat instrukce nastavení`
### Povinné kontroly
Před odesláním PR:
1. **Kvalita kódu**:
- Spusťte `npm run lint` v ovlivněných projektových složkách
- Opravte všechny lintovací chyby a varování
- Spusťte `npm run lint` v dotčených projektech
- Opravte všechny chyby a varování
2. **Ověření sestavení**:
- Spusťte `npm run build`, pokud je relevantní
- Zajistěte, že nejsou chyby sestavení
2. **Ověření buildů**:
- Spusťte `npm run build` kde je to potřeba
- Zajistěte bezchybný build
3. **Ověření odkazů**:
- Otestujte všechny markdown odkazy
- Ověřte fungování referencí obrázků
- Zkontrolujte funkčnost odkazů na obrázky
4. **Kontrola obsahu**:
- Korektury pravopisu a gramatiky
- Ověření správnosti a vzdělávací hodnoty příkladů kódu
- Ověření, že překlady zachovávají původní význam
- Korektura pravopisu a gramatiky
- Ověřte správnost a edukační hodnotu příkladů kódu
- 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)
- Dodržujte [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Souhlas s Microsoft CLA (automatická kontrola při prvním PR)
- Dodržovat [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- 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
- PR kontrolují správci a komunita
- Prioritou je vzdělávací srozumitelnost
- Příklady kódu by měly odpovídat aktuálním nejlepším praktikám
- Překlady se kontrolují z hlediska přesnosti a kulturní vhodnosti
- PR jsou kontrolovány správci a komunitou
- Prioritní je srozumitelnost pro vzdělávání
- Příklady kódu by měly odpovídat aktuálním osvědčeným postupům
- Překlady jsou pečlivě revidovány pro přesnost a kulturní vhodnost
## Překladový systém
### Automatizovaný překlad
### Automatický překlad
- Používá GitHub Actions s workflow co-op-translator
- Automaticky překládá do více než 50 jazyků
- Zdrojové soubory v hlavních adresářích
- Přeložené soubory v adresářích `translations/{jazykový-kód}/`
- Př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}/`
2. Proveďte úpravy s zachováním struktury
3. Ověřte, že příklady kódu zůstávají funkční
4. Testujte lokalizovaný obsah kvízů
1. Najděte soubor ve složce `translations/{language-code}/`
2. Proveďte vylepšení se zachováním struktury
3. Ujistěte se, že příklady kódu zůstávají funkční
4. Otestujte lokalizovaný obsah kvízů
### Metadata překladu
Přeložené soubory obsahují hlavičku metadat:
Přeložené soubory obsahují hlavičku s metadaty:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -295,50 +295,50 @@ CO_OP_TRANSLATOR_METADATA:
**Quiz app se nespustí**:
- Zkontrolujte verzi Node.js (doporučeno v14+)
- Smažte `node_modules` a `package-lock.json`, spusťte znovu `npm install`
- Zkontrolujte konflikty portů (výchozí: Vite používá port 5173)
- Odstraňte `node_modules` a `package-lock.json`, spusťte `npm install` znovu
- Zkontrolujte konflikt portů (výchozí: Vite používá port 5173)
**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
- 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
- Zkontrolujte prohlížečovou konzoli na chyby
- Postupujte podle návodů k instalaci rozšíření specifických pro prohlížeč
- Zkontrolujte chyby v konzoli prohlížeče
- Postupujte podle pokynů instalace pro konkrétní prohlížeč
**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
- 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`
- 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í
- Používejte VS Code s rozšířením Live Server pro HTML projekty
- Nainstalujte rozšíření ESLint a Prettier pro konzistentní formátování
- Použijte DevTools v prohlížeči pro debugování JavaScriptu
- Pro Vue projekty nainstalujte Vue DevTools rozšíření do prohlížeče
- Používejte DevTools prohlížeče pro ladění JavaScriptu
- 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
- Pro práci pouze s obsahem použijte shallow clone: `git clone --depth 1`
- Při práci s anglickým obsahem vylučujte překlady z vyhledávání
- První běh build procesů může být pomalý (npm install, Vite build)
- Velké množství přeložených souborů (50+ jazyků) znamená, že klony jsou velké
- Použijte shallow clone, pokud pracujete pouze s obsahem: `git clone --depth 1`
- Při práci na anglickém obsahu vynechejte překlady z vyhledávání
- 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í
- API klíče by se nikdy neměly commitovat do repozitáře
- Používejte `.env` soubory (j v `.gitignore`)
- Dokumentujte požadované proměnné prostředí v README projektech
- API klíče nikdy nezadávejte do repozitáře
- Používejte `.env` soubory (jsou uvedeny v `.gitignore`)
- Dokumentujte požadované proměnné v README projektů
### Python projekty
@ -348,61 +348,61 @@ CO_OP_TRANSLATOR_METADATA:
### Přístup k GitHub Models
- Pro GitHub Models jsou potřeba Personal Access Tokens (PAT)
- Tokeny ukládejte jako proměnné prostředí
- Nikdy necommitujte tokeny či přihlašovací údaje
- Osobní přístupové tokeny (PAT) jsou nutné pro GitHub Models
- Tokeny by měly být uloženy jako proměnné prostředí
- Nikdy neukládejte tokeny nebo přihlašovací údaje do repozitáře
## Další poznámky
### 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
- Učitelé používající kurikulum ve třídách
- Obsah je navržen pro přístupnost a postupné rozvíjení dovedností
- Učitelé využívající kurikulum ve třídách
- Obsah je navržen pro přístupnost a postupné budování dovedností
### Vzdělávací filozofie
- Přístup založený na projektech
- Časté ověřování znalostí (kvízy)
- Praktická cvičení kódování
- Příklady využití v reálném světě
- Časté kontroly znalostí (kvízy)
- Praktická cvičení v kódování
- Příklady z reálného světa
- Zaměření na základy před frameworky
### Údržba repozitáře
- Aktivní komunita studentů a přispěvatelů
- Pravidelné aktualizace závislostí a obsahu
- Sledují se issues a diskuse správci
- Aktualizace překladů automatizovány přes GitHub Actions
- Problémy a diskuze jsou monitorovány správci
- Aktualizace překladů jsou automatizovány přes GitHub Actions
### Související zdroje
- [Microsoft Learn moduly](https://docs.microsoft.com/learn/)
- [Student Hub zdroje](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) doporučený pro studenty
- Další kurzy: Generativní AI, Data Science, ML, IoT kurikula dostupná
- 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:
- `quiz-app/README.md` - Vue 3 kvízová aplikace
- `7-bank-project/README.md` - Bankovní aplikace s autentifikací
- `quiz-app/README.md` - Vue 3 aplikace kvízu
- `7-bank-project/README.md` - Bankovní aplikace s autentizací
- `5-browser-extension/README.md` - Vývoj rozšíření prohlížeče
- `6-space-game/README.md` - Vývoj hry s využitím Canvas
- `6-space-game/README.md` - Vývoj hry na canvasu
- `9-chat-project/README.md` - Projekt AI chat asistenta
### 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á
- Projekty nesdílí závislosti
- Pracujte na jednotlivých projektech, aniž byste ovlivnili ostatní
- Pro plný kurz si naklonujte celý repozitář
- Projekty nesdílejí závislosti
- Pracujte na jednotlivých projektech bez ovlivnění ostatních
- Pro plný zážitek klonujte celý repozitář kurikula
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**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.
**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 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 -->

@ -1,7 +1,7 @@
{
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8",
"translation_date": "2026-03-06T15:55:42+00:00",
"original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-27T19:38:33+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "hu"
},
@ -493,7 +493,7 @@
},
"AGENTS.md": {
"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",
"language_code": "hu"
},

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

@ -1,7 +1,7 @@
{
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8",
"translation_date": "2026-03-06T15:47:51+00:00",
"original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-27T19:33:46+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "sw"
},
@ -493,7 +493,7 @@
},
"AGENTS.md": {
"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",
"language_code": "sw"
},

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