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

pull/1793/head
localizeflow[bot] 4 weeks ago
parent eeb49d1ae2
commit 2fae1b526d

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"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",
"language_code": "cs"
},

@ -2,29 +2,29 @@
## 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
- **Praktické projekty**: Terrárium, Hra na psaní, Rozšíření prohlížeče, Vesmírná hra, Bankovní aplikace, Kódový editor a AI Chat asistent
- **Interaktivní kvízy**: 48 kvízů s 3 otázkami každého (před a po lekci)
- **Podpora vícejazyčnosti**: Automatizované překlady do více než 50 jazyků pomocí GitHub Actions
- **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í, Prodlžek prohlížeče, Hra ve vesmíru, Bankovní aplikace, Kódový editor a AI chatovací asistent
- **Interaktivní kvízy**: 48 kvízů po 3 otázkách (testy před a po lekci)
- **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)
### Architektura
- Vzdělávací repozitář se strukturou založenou na lekcích
- Každá složka lekce obsahuje README, příklady kódu a řešení
- Samostatné projekty v oddělených adresářích (quiz-app, různorodé projekty lekcí)
- Překladový systém používající GitHub Actions (co-op-translator)
- Dokumentace poskytována přes Docsify a dostupná jako PDF
- Samostatné projekty v oddělených adresářích (quiz-app, různé projektové lekce)
- Překladový systém využívající GitHub Actions (co-op-translator)
- 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
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
@ -48,10 +48,10 @@ cd 7-bank-project/api
npm install
npm start # Spusťte API server
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
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č
```
### Projekty vesmírné hry
### Projekty hry ve vesmíru
```bash
cd 6-space-game/solution
@ -67,7 +67,7 @@ npm install
# Otevřete index.html v prohlížeči nebo použijte Live Server
```
### Chat projekt (Python Backend)
### Chatovací projekt (Python Backend)
```bash
cd 9-chat-project/solution/backend/python
@ -76,120 +76,120 @@ pip install openai
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ě
3. **Vytvořte novou větev** pro své změny
4. Proveďte změny v obsahu lekcí nebo příkladech kódu
5. Testujte jakékoliv změny kódu v příslušných adresářích projektů
6. Odešlete pull requesty podle pokynů pro přispívání
4. Proveďte změny ve vzdělávacím obsahu nebo příkladech kódu
5. Otestujte jakékoliv změny kódu v příslušných adresářích projektů
6. Odešlete pull requesty dle pokynů pro přispívání
### Pro studenty
1. Forkujte nebo klonujte repozitář
2. Procházejte složky lekcí sekvenč
3. Čtěte README soubory každé lekce
4. Dokončete před- lekční kvízy na https://ff-quizzes.netlify.app/web/
5. Procházejte příklady kódu ve složkách lekcí
6. Dokončete úkoly a výzvy
7. Udělejte post- lekční kvízy
1. Vytvořte fork nebo klonujte repozitář
2. Procházejte adresáře lekcí postup
3. Čtěte README soubory ke každé lekci
4. Dokončete kvízy před lekcí na https://ff-quizzes.netlify.app/web/
5. Procházejte příklady kódu v adreřích lekcí
6. Splňte úkoly a výzvy
7. Dokončete kvízy po lekci
### Živý vývoj
- **Dokumentace**: Spusťte `docsify serve` v kořenovém adresáři (port 3000)
- **Quiz App**: Spusťte `npm run dev` ve složce quiz-app
- **Projekty**: Použijte VS Code Live Server rozšíření pro HTML projekty
- **Quiz App**: Spusťte `npm run dev` v adresáři quiz-app
- **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
## Instrukce k testování
## Pokyny k testování
### Testování Quiz App
```bash
cd quiz-app
npm run lint # Zkontrolujte problémy se stylem kódu
npm run build # Ověřte, že sestavení proběhne úspěšně
npm run build # Ověřte, zda sestavení proběhne úspěšně
```
### Testování Bank API
```bash
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
```
### 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:
- 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
- Úspěšné sestavení projektů
- Příklady vyhovují zásadám best practices
- Úspěšné dokončení buildů projektů
- 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
- Ověřte, že odkazy v markdownu jsou platné
- Otestujte příklady kódu v prohlížeči nebo Node.js
- Zkontrolujte, že překlady zachovávají správnou strukturu
- 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 správnou strukturu překladů
## Směrnice stylu kódu
## Směrnice pro styl kódu
### JavaScript
- Používejte moderní ES6+ syntaxi
- Používejte moderní syntax ES6+
- Dodržujte standardní konfigurace ESLint v projektech
- Používejte názvy proměnných a funkcí, které jsou srozumitelné pro výuku
- Přidávejte komentáře vysvětlující koncepty pro studenty
- Formátujte pomocí Prettier tam, kde je nakonfigurováno
- 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 studentům
- Formátujte pomocí Prettier tam, kde je nastaven
### HTML/CSS
- Semantické HTML5 prvky
- Sémantické HTML5 prvky
- 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
### Python
- Směrnice stylu PEP 8
- Dodržujte PEP 8 styl
- 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ů
- Bloky kódu s označením jazyka
- Odkazy na doplňkové zdroje
- Screenshoty a obrázky ve složkách `images/`
- Alternativní texty pro obrázky pro přístupnost
- Přehledná hierarchie nadpisů
- Kódové bloky s uvedením jazyka
- Odkazy na další zdroje
- Snímky obrazovky a obrázky v adresářích `images/`
- Alternativní text obrázků pro přístupnost
### Organizace souborů
- Lekce číslovány sekvenčně (1-getting-started-lessons, 2-js-basics, atd.)
- Každý projekt má složky `solution/` a často `start/` nebo `your-work/`
- Obrázky uložené v lekcemi specifických složkách `images/`
- Překlady ve struktuře `translations/{language-code}/`
- Lekce číslované sekvenčně (1-getting-started-lessons, 2-js-basics, atd.)
- Každý projekt má adresáře `solution/` a často `start/` nebo `your-work/`
- Obrázky uložené ve složkách `images/` specifických pro lekce
- Překlady v adresářové struktuře `translations/{language-code}/`
## Sestavení a nasazení
### 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
cd quiz-app
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:
- **Místo aplikace**: `/quiz-app`
- **Umístění aplikace**: `/quiz-app`
- **Výstupní umístění**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
@ -197,82 +197,82 @@ Konfigurace Azure Static Web Apps:
```bash
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
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
- 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
### 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`
- `[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`
- `[Docs] Aktualizace instrukcí pro nastavení`
- `[Docs] Aktualizovat instrukce k nastavení`
### Požadované kontroly
Před odesláním PR:
1. **Kvalita kódu**:
- Spusťte `npm run lint` ve zasažených projech složkách
- Opravte všechny linting chyby a varování
- Spusťte `npm run lint` v dotčených projektech
- Opravte všechny lintovací chyby a varování
2. **Ověření sestavení**:
- Spusťte `npm run build` pokud je to relevantní
- Zajistěte, že nejsou chyby při sestavení
2. **Ověření buildů**:
- Spusťte `npm run build` pokud je relevantní
- Ujistěte se, že build proběhl bez chyb
3. **Validace odkazů**:
3. **Kontrola odkazů**:
- Otestujte všechny markdown odkazy
- Ověřte funkčnost odkazů na obrázky
- Ověřte pracovní odkazy na obrázky
4. **Kontrola obsahu**:
- Korektura pravopisu a gramatiky
- Ověření správnosti a vzdělávací hodnoty příkladů kódu
- Validace, že překlady zachovávají původní význam
- Zajištění správnosti a vzdělávací hodnoty příkladů kódu
- Ověření správnosti překladů
### 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/)
- 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
- PRs jsou revidovány správci i komunitou
- Prioritizuje se vzdělávací srozumitelnost
- Příklady kódu by měly odpovídat aktuálním best practices
- Překlady jsou kontrolovány na přesnost a kulturní vhodnost
- PR kontrolují správci a komunita
- Upřednostňuje se vzdělávací jasnost
- Příklady kódu by měly odpovídat současným osvědčeným postupům
- Překlady se kontrolují na přesnost a kulturní vhodnost
## Překladový systém
### Automatizovaný překlad
### Automatický překlad
- 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
- 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}/`
2. Proveďte vylepšení při zachování struktury
3. Zajistěte, že příklady kódu zůstanou funkční
4. Otestujte případný lokalizovaný obsah kvízů
3. Zajistěte funkčnost příkladů kódu
4. Otestujte případný lokalizovaný kvízový obsah
### 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
**Quiz app se nespustí**:
- Zkontrolujte verzi Node.js (doporučeno v14+)
- Odstraňte `node_modules` a `package-lock.json`, znovu spusťte `npm install`
- Zkontrolujte konflikty portu (výchozí: Vite používá port 5173)
- Odstraňte `node_modules` a `package-lock.json`, spusťte `npm install` znovu
- Zkontrolujte konflikty portů (výchozí: Vite používá port 5173)
**API server se nespustí**:
- Ověřte verzi Node.js (node >=10)
- Zkontrolujte, zda port není již obsazen
- Ověřte minimální verzi Node.js (node >=10)
- Zkontrolujte, zda port není obsazen
- Ujistěte se, že všechny závislosti jsou nainstalovány pomocí `npm install`
**Rozšíření prohlížeče se nenačte**:
- Ověřte správné formátování manifest.json
- Kontrolujte konzoli prohlížeče na chyby
- Postupujte podle specifických instrukcí pro instalaci rozšíření v daném prohlížeči
**Prodlžek prohlížeče se nenačítá**:
- Zkontrolujte, že manifest.json je správně formátován
- Prohlédněte konzoli prohlížeče kvůli chybám
- Postupujte podle specifických instrukcí pro instalaci prodlužků v prohlížeči
**Problémy s Python chat projektem**:
- Ujistěte se, že je nainstalovaný balíček OpenAI: `pip install openai`
- Ověřte nastavení proměnné prostředí GITHUB_TOKEN
- Zkontrolujte oprávnění přístupu k GitHub Models
- Ujistěte se, že je nainstalován balík OpenAI: `pip install openai`
- Zkontrolujte, že je nastavena proměnná prostředí GITHUB_TOKEN
- Prověřte oprávnění přístupu k GitHub Models
**Docsify neslouží dokumentaci**:
- Nainstalujte docsify-cli globálně: `npm install -g docsify-cli`
- Spouštějte z kořenového adresáře repozitáře
**Docsify nedoručuje dokumenty**:
- Globálně nainstalujte docsify-cli: `npm install -g docsify-cli`
- Spusťte ze základního adresáře repozitáře
- Ověřte, že existuje `docs/_sidebar.md`
### Tipy pro vývojové prostředí
- Používejte VS Code s Live Server rozšířením pro HTML projekty
- Instalujte rozšíření ESLint a Prettier pro konzistentní formátování
- 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ží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`
- Při práci s anglickým obsahem vylučujte překlady z vyhledávání
- Sestavovací procesy mohou být pomalé při prvním spuštění (npm install, Vite build)
- Při práci s angličtinou vylučte překlady z hledání
- Build procesy mohou být pomalé při prvním spuštění (npm install, Vite build)
## Bezpečnostní aspekty
### Proměnné prostředí
- API klíče by 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`)
- Dokumentujte požadované proměnné prostředí v README projektů
### Python projekty
- 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í
### 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í
- Nikdy necommitujte tokeny nebo přihlašovací údaje
- Nikdy nesdílejte tokeny ani přihlašovací údaje v repozitáři
## 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
- Učitelé používající kurikulum ve třídách
- Obsah je navržen pro přístupnost a postupné budování dovedností
### Vzdělávací filozofie
- Případová výuka založená na projektech
- Přístup založený na projektech
- Časté kontroly znalostí (kvízy)
- Praktické programovací cvičení
- Příklady reálného použití
- Praktické kódovací cvičení
- Příklady aplikací z reálného světa
- Zaměření na základy před frameworky
### Údržba repozitáře
- Aktivní komunita studentů a přispěvatelů
- Pravidelné aktualizace závislostí a obsahu
- Problémy a diskuze monitorované správci
- Automatické aktualizace překladů přes GitHub Actions
- Problémy a diskuse spravovány správci
- Aktualizace překladů 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čeno pro studenty
- Další kurzy: Generativní AI, Data Science, ML, IoT kurikula dostupná
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) doporučen pro studenty
- Další kurzy: Generativní AI, Data Science, ML, IoT dostupné kurikula
### 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
- `7-bank-project/README.md` - Bankovní aplikace s ověřováním
- `5-browser-extension/README.md` - Vývoj rozšíření prohlížeče
- `6-space-game/README.md` - Vývoj hry založené na canvasu
- `7-bank-project/README.md` - Bankovní aplikace s autentizací
- `5-browser-extension/README.md` - Vývoj prodlužků prohlížeče
- `6-space-game/README.md` - Vývoj hry na canvasu
- `9-chat-project/README.md` - Projekt AI chat asistenta
### 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á
- Projekty nesdílí závislosti
- Práce na jednotlivých projektech bez ovlivnění ostatních
- Klonujte celý repozitář pro plný zážitek z kurikula
- Práce na jednotlivých projektech neovlivňuje ostatní
- Naklonujte celý repozitář pro plný zážitek kurikula
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Upozornění**:
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.
**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 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 -->

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"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",
"language_code": "hu"
},

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

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"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",
"language_code": "sw"
},

@ -2,36 +2,36 @@
## 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
- **Maudhui ya Elimu**: Masomo 24 yaliyopangiliwa kwa muundo wa moduli zinazotegemea 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
- **Mitihani ya Kuingiliana**: Mitihani 48 yenye maswali 3 kila moja (mapema/kwa baada ya somo)
- **Usaidi wa Lugha Nyingi**: Tafsiri za moja kwa moja kwa lugha zaidi ya 50 kupitia GitHub Actions
- **Yaliyomo ya Elimu**: Masomo 24 yaliyopangwa kwa muundo wa moduli za miradi
- **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
- **Maswali Shindani Ya Kihusianisho**: Maswali 48 kila moja ikiwa na maswali 3 (majaribio kabla/baada ya somo)
- **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)
### Miundo
### Miundo-Mbinu
- Hifadhidata ya elimu yenye muundo wa somo kwa somo
- Kila folda ya somo ina README, mifano ya nambari, na suluhisho
- Miradi huru katika saraka tofauti (quiz-app, miradi mbalimbali ya somo)
- Hazina ya elimu yenye muundo wa masomo
- Kila folda ya somo ina README, mifano ya msimbo, na suluhisho
- Miradi huru katika saraka tofauti (quiz-app, miradi mbalimbali ya masomo)
- Mfumo wa tafsiri ukitumia GitHub Actions (co-op-translator)
- 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
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### Usanidi wa Quiz App (Vue 3 + Vite)
### Kuanzisha Quiz App (Vue 3 + Vite)
```bash
cd quiz-app
@ -48,15 +48,15 @@ cd 7-bank-project/api
npm install
npm start # Anzisha seva ya API
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
cd 5-browser-extension/solution
npm install
# Fuata maelekezo ya kupakia ugani kwa kivinjari maalum
# Fuata maagizo ya kupakia upanuzi maalum kwa kivinjari
```
### Miradi ya Mchezo wa Anga
@ -72,128 +72,128 @@ npm install
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# Weka mazingira ya mabadiliko ya GITHUB_TOKEN
# Weka kigezo cha mazingira cha GITHUB_TOKEN
python api.py
```
## Mtiririko wa Maendeleo
### Kwa Wachangiaji wa Maudhui
### Kwa Wasaidizi wa Yaliyomo
1. **Fungua hifadhidata** kwenye akaunti yako ya GitHub
2. **Dondoa hifadhidata hii** mahali pako pa kazi
1. **Fungua hazina kwa fork** kwa akaunti yako ya GitHub
2. **Nakili fork yako** mahali hapo ndani
3. **Tengeneza tawi jipya** kwa mabadiliko yako
4. Fanya mabadiliko kwenye maudhui ya somo au mifano ya nambari
5. Jaribu mabadiliko ya nambari katika saraka za miradi husika
6. Tuma ombi la mvutano kwa kufuata miongozo ya mchango
4. Fanya mabadiliko kwenye yaliyomo ya masomo au mifano ya msimbo
5. Jaribu mabadiliko yoyote ya msimbo katika saraka za miradi husika
6. Wasilisha rufaa za kuchukua mabadiliko kuzingatia miongozo ya mchango
### Kwa Wanafunzi
1. Fungua au dondoa hifadhidata
2. Pitia saraka za masomo kwa mpangilio
3. Soma mafaili ya README kwa kila somo
4. Maliza mitihani ya kabla ya somo kwenye https://ff-quizzes.netlify.app/web/
5. Fanya kazi kwa mfano wa nambari katika folda za somo
6. Maliza kazi na changamoto
7. Fanya mitihani ya baada ya somo
1. Funga au nakili hazina
2. Elekea kwenye saraka za masomo kwa mpangilio
3. Soma faili za README kwa kila somo
4. Maliza maswali ya kabla ya somo huko https://ff-quizzes.netlify.app/web/
5. Fanyia kazi mifano ya msimbo katika folda za masomo
6. Maliza kazi za nyumbani na changamoto
7. Fanya maswali ya baada ya somo
### Maendeleo Unaioishi
### Maendeleo Hai
- **Nyaraka**: Endesha `docsify serve` katika saraka kuu (bandari 3000)
- **Quiz App**: Endesha `npm run dev` katika saraka ya quiz-app
- **Miradi**: Tumia ugani wa VS Code Live Server kwa miradi ya HTML
- **Nyaraka**: Endesha `docsify serve` kwenye saraka ya juu (bandari 3000)
- **Quiz App**: Endesha `npm run dev` kwenye folda ya quiz-app
- **Miradi**: Tumia upanuzi wa VS Code Live Server kwa miradi ya HTML
- **Miradi ya API**: Endesha `npm start` katika saraka husika za API
## Maelekezo ya Kupima
### Upimaji wa Quiz App
### Kupima Quiz App
```bash
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
```
### Upimaji wa Bank API
### Kupima API ya Benki
```bash
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
```
### Mbinu ya Upimaji kwa Jumla
### Mbinu ya Kupima kwa Ujumla
- Hii ni hifadhidata ya elimu isiyo na majaribio ya moja kwa moja ya kina
- Upimaji wa mikono unalenga:
- Mifano ya nambari iaendeshwe bila makosa
- Viungo katika nyaraka vifanye kazi kwa usahihi
- Ujenzi wa mradi ukamilike kwa mafanikio
- Mifano ifuatilie mbinu bora
- Hii ni hazina ya elimu isiyo na majaribio ya moja kwa moja ya kina
- Kupima kwa mikono kunalenga:
- Mifano ya msimbo inakimbia bila makosa
- Viungo vya nyaraka vinafanya kazi kikamilifu
- Miradi kujengwa kikamilifu bila hitilafu
- Mifano inafuata mbinu bora
### Ukaguzi wa Kabla ya Kuwasilisha
### Ukaguzi Kabla ya Kuwasilisha
- Endesha `npm run lint` katika saraka zenye package.json
- Hakiki viungo vya markdown viko sahihi
- Jaribu mifano ya nambari kwenye kivinjari au Node.js
- Hakiki tafsiri zihakikishe muundo unahifadhiwa
- Endesha `npm run lint` katika saraka zilizo na package.json
- Hakiki viungo vya markdown vipate usahihi
- Jaribu mifano ya msimbo kwenye kivinjari au Node.js
- Hakikisha tafsiri zinahifadhi muundo sahihi
## Miongozo ya Mtindo wa Msimbo
### JavaScript
- Tumia msimbo wa kisasa wa ES6+
- Fuata mipangilio ya ESLint inayotolewa katika miradi
- Tumia majina ya maana kwa vigezo na kazi kwa uwazi wa kielimu
- Tumia lugha ya kisasa ya ES6+
- Fuata mipangilio ya kawaida ya ESLint iliyopo katika miradi
- Tumia majina yenye maana kwa mabadiliko na kazi kwa ajili ya ufafanuzi wa elimu
- Ongeza maelezo kuelezea dhana kwa wanafunzi
- Tumia Prettier kwa uundaji ikiwa imewekwa
- Tengeneza kwa kutumia Prettier pale panapopangwa
### HTML/CSS
- Vipengele vya semantic vya HTML5
- Misingi ya muundo wa kujibadilisha (responsive)
- Miundo ya majina ya darasa wazi
- Maelezo yanayoelezea mbinu za CSS kwa wanafunzi
- Kanuni za muundo wa kujibadilisha (responsive)
- Viwango vya uandishi vya darasa wazi
- Maelezo kuelezea mbinu za CSS kwa wanafunzi
### Python
- Miongozo ya mtindo wa PEP 8
- Mifano ya nambari wazi, ya kielimu
- Maelezo ya aina pale yanaposaidia kujifunza
- Miongozo ya mtindo ya PEP 8
- Mifano ya msimbo wazi, ya elimu
- Vidokezo vya aina inapobidi kwa kujifunza
### Nyaraka za Markdown
- Muundo wazi wa vichwa
- Vizuizi vya msimbo na maelezo ya lugha
- Viungo vya rasilimali za ziada
- Picha za skrini na picha katika saraka `images/`
- Maandishi ya alt kwa picha kwa upatikanaji
- Muundo wa vichwa vya habari kwa uwazi
- Mifumo ya msimbo yenye lugha maalum
- Viungo kwenye rasilimali za ziada
- Picha na picha ndogo katika saraka za `images/`
- Maandishi ya alt ya picha kwa upatikanaji
### 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/`
- 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}/`
## 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
cd quiz-app
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:
- **Mahali pa app**: `/quiz-app`
- **Mahali pa pato**: `dist`
Mipangilio ya Azure Static Web Apps:
- **Eneo la app**: `/quiz-app`
- **Eneo la matokeo**: `dist`
- **Mtiririko wa kazi**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Uzalishaji PDF wa Nyaraka
### Uzalishaji 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 # Install Docsify ulimwenguni kote
docsify serve # Hudumia kwenye localhost:3000
npm install -g docsify-cli # Sakinisha Docsify kote duniani
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:
- Miradi ya Vue: `npm run build` hutengeneza vifurushi vya uzalishaji
- Miradi ya static: Hakuna hatua ya ujenzi, hudumu faili moja kwa moja
- Miradi ya Vue: `npm run build` huunda vifurushi vya uzalishaji
- 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
Tumia vichwa vya wazi vinavyoelezea eneo la mabadiliko:
Tumia vichwa wazi, vinavyoelezea maeneo ya mabadiliko:
- `[Quiz-app] Ongeza mtihani mpya kwa somo X`
- `[Lesson-3] Rekebisha tahajia katika mradi wa terrarium`
- `[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**:
- Endesha `npm run lint` katika saraka za mradi zilizoathirika
- Rekebisha makosa na tahadhari zote za lint
- Endesha `npm run lint` katika saraka zilizoathirika
- Rekebisha makosa na onyo zote za lint
2. **Uhakiki wa Ujenzi**:
- Endesha `npm run build` ikiwa inahitajika
- Endesha `npm run build` inapohitajika
- Hakikisha hakuna makosa ya ujenzi
3. **Uhakiki wa Viungo**:
- Jaribu viungo vyote vya markdown
- Hakiki marejeo ya picha yanafanya kazi
- Thibitisha marejeo ya picha zinafanya kazi
4. **Ukaguzi wa Maudhui**:
- Soma tena kwa tahajia na sarufi
- Hakikisha mifano ya nambari ni sahihi na ya kielimu
- Hakiki tafsiri zihakikishe maana asili inahifadhiwa
4. **Ukaguzi wa Yaliyomo**:
- Soma kwa makini kwa makosa ya tahajia na sarufi
- Hakikisha mifano ya msimbo ni sahihi na ya kielimu
- Hakikisha tafsiri zinahifadhi maana asilia
### Mahitaji ya Mchango
### Masharti ya Michango
- 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/)
- Tazama [CONTRIBUTING.md](./CONTRIBUTING.md) kwa miongozo ya kina
- Taja nambari za masuala katika maelezo ya PR ikiwa zinahusika
- Kubali Microsoft CLA (ukaguzi wa moja kwa moja kwa PR ya kwanza)
- Fuata [Sheria za Maadili za Chanzo Huria za Microsoft](https://opensource.microsoft.com/codeofconduct/)
- Angalia [CONTRIBUTING.md](./CONTRIBUTING.md) kwa miongozo ya kina
- Taja nambari za masuala katika maelezo ya PR inapowezekana
### Mchakato wa Mapitio
### Mchakato wa Ukaguzi
- PR hupitiwa na watunza na jamii
- Uwiano wa elimu unapewa kipaumbele
- Mifano ya nambari ifuatilie mbinu bora za sasa
- Tafsiri hupitiwa kwa usahihi na ulinganishaji wa kitamaduni
- PR hurejelewa na waendelezaji na jamii
- Uwazi wa elimu unaangaziwa
- Mifano ya msimbo inapaswa kufuata mbinu bora za sasa
- Tafsiri hurejelewa kwa usahihi na utamaduni unaofaa
## Mfumo wa Tafsiri
### Tafsiri ya Moja kwa Moja
### Tafsiri ya Moja kwa Moja (Automated)
- 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 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}/`
2. Fanya maboresho huku ukihifadhi muundo
3. Hakikisha mifano ya nambari inaendelea kufanya kazi
4. Jaribu maudhui ya mitihani ya eneo waliloitafsiriwa
3. Hakikisha mifano ya msimbo inabaki kutumika
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
<!--
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**:
- Angalia toleo la Node.js (v14+ inapendekezwa)
- Futa `node_modules` na `package-lock.json`, endesha `npm install` tena
- Hakiki mgongano wa bandari (kawaida: Vite hutumia bandari 5173)
**App ya Quiz haianzi**:
- Hakiki toleo la Node.js (inashauriwa v14+)
- Futa `node_modules` na `package-lock.json`, endesha tena `npm install`
- Angalia migongano ya bandari (kawaida: Vite hutumia bandari 5173)
**Server ya API haishi**:
- Thibitisha toleo la Node.js linakidhi minimum (node >=10)
- Angalia ikiwa bandari imeshatumika tayari
- Hakikisha tegemezi zote zimewekwa kwa `npm install`
**Server ya API haianzi**:
- Hakiki toleo la Node.js linakidhi (node >=10)
- Angalia kama bandari tayari inatumika
- Hakikisha utegemezi wote umetolewa kwa `npm install`
**Kiongezi cha kivinjari hakianzi**:
- Hakiki kuwa manifest.json imepangwa kwa usahihi
**Upanuzi wa kivinjari hauanziki**:
- Hakiki manifest.json imepandishwa vema
- 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**:
- Thibitisha kifurushi cha OpenAI kimesakinishwa: `pip install openai`
- Hakiki mazingira ya GITHUB_TOKEN yamewekwa
- Angalia ruhusa za GitHub Models
**Matatizo ya Mradi wa Mazungumzo wa Python**:
- Hakikisha kifurushi cha OpenAI kimesakinishwa: `pip install openai`
- Hakiki kuwa mabadiliko ya mazingira ya GITHUB_TOKEN yamewekwa
- Hakiki vibali vya ufikiaji kwa GitHub Models
**Docsify haitumii nyaraka**:
- Sakinisha docsify-cli duniani: `npm install -g docsify-cli`
- Endesha kutoka saraka kuu ya hifadhidata
- Hakiki kuwa `docs/_sidebar.md` ipo
**Docsify haisikilizi nyaraka**:
- Sakinisha docsify-cli ulimwenguni: `npm install -g docsify-cli`
- Endesha kutoka saraka kuu ya hazina
- Hakiki `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 uundaji thabiti
- Tumia DevTools za kivinjari kutatua matatizo ya JavaScript
- Kwa miradi ya Vue, sakinisha Vue DevTools ugani wa kivinjari
- Tumia VS Code na upanuzi wa Live Server kwa miradi ya HTML
- Sakinisha upanuzi za ESLint na Prettier kwa mtindo thabiti
- Tumia DevTools wa kivinjari kwa kupata na kutatua makosa ya JavaScript
- 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
- Tumia shallow clone wakati unafanya kazi tu na maudhui: `git clone --depth 1`
- Epuka tafsiri wakati wa kufanya kazi na maudhui ya Kiingereza
- Mchakato wa ujenzi unaweza kuwa polepole kwa mara ya kwanza (npm install, ujenzi wa Vite)
- Idadi kubwa ya faili za tafsiri (za lugha 50+) huongeza ukubwa wa nakala kamili
- Tumia nakala ya chini (shallow) ikiwa unafanya kazi tu kwa yaliyomo: `git clone --depth 1`
- Epuka tafutiza za tafsiri wakati unafanya kazi na yaliyomo ya Kiingereza
- Mienendo ya ujenzi inaweza kuwa polepole mwanzoni (npm install, ujenzi wa Vite)
## Mambo ya Usalama
## Masuala ya Usalama
### Mabadiliko ya Mazingira
- Funguo za API hazipaswi kungolewa hifadhidatani
- Tumia faili za `.env` (zipo tayari katika `.gitignore`)
- Andika mabadiliko ya mazingira yanayohitajika katika README za miradi
- Funguo za API hazipaswi kuwekwa moja kwa moja katika hazina
- Tumia faili za `.env` (zipo katika `.gitignore`)
- Elezea mabadiliko ya mazingira yanayohitajika katika README za miradi
### Miradi ya Python
- Tumia mazingira ya virtual: `python -m venv venv`
- Dumisha dependencies zikisasishwa
- Tokens za GitHub zisiwe na ruhusa zaidi ya zisizohitajika
- Tumia mazingira ya pekee: `python -m venv venv`
- Sasisha utegemezi mara kwa mara
- Tokeni za GitHub zinapaswa kuwa na vibali vidogo vinavyotakiwa tu
### Ufikiaji wa GitHub Models
- Tokens za Ufikiaji Binafsi (PAT) zinahitajika kwa GitHub Models
- Tokens zihifadhiwe kama mabadiliko ya mazingira
- Kamwe usiweke tokens au nyaraka za usalama hifadhidatani
- Mipangilio ya Ufikiaji wa Kibinafsi (PAT) inahitajika kwa GitHub Models
- Tokeni ziwe katika mabadiliko ya mazingira
- Kamwe usiweka tokeni au nyaraka katika hazina
## Vidokezo Zaidi
### Hadhira Lengwa
- Waanzilishi kabisa wa maendeleo ya wavuti
- Wanafunzi na wanaojifunza peke yao
- Walimu wanaotumia mtaala katika madarasa
- Maudhui yamebuniwa kwa upatikanaji na kujenga ujuzi polepole
- Wananchi wapya kabisa katika maendeleo ya wavuti
- Wanafunzi na waelimishaji wa kujifunza peke yao
- Walimu wanaotumia mtaala darasani
- Yaliyomo yamebuniwa kwa kupatikana na kukuza hatua kwa hatua ujuzi
### Falsafa ya Elimu
- Mbinu ya kujifunza kwa mradi
- Vipimo vya mara kwa mara vya maarifa (quiz)
- Mazoezi ya kuandika msimbo kwa mikono
- Mifano ya matumizi halisi
- Kuzingatia misingi kabla ya mifumo ya kazi
- Mbinu ya kujifunza kwa miradi
- Ukaguzi wa mara kwa mara wa maarifa (maswali)
- Mazoezi ya kuandika msimbo kwa vitendo
- Mifano ya matumizi halisi ya dunia ya kweli
- Kuzingatia misingi kabla ya mifumo ngumu
### Matunzo ya Hifadhidata
### Matengenezo ya Hazina
- Jamii hai ya wanafunzi na wachangiaji
- Sasisho za mara kwa mara kwa tegemezi na maudhui
- Masuala na majadiliano yanatiliwa mkazo na watunza
- Sasisho za tafsiri kwa njia ya otomatiki kupitia GitHub Actions
- Jamii hai ya wanafunzi na wasaidizi
- Sasisho za mara kwa mara za utegemezi na yaliyomo
- Masuala na majadiliano yanatazamwa na watunzaji
- Sasisho za tafsiri zimepangwa 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/)
- [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
- 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:
- `quiz-app/README.md` - Programu ya kucheza quiz ya Vue 3
Kwa maelekezo ya kina juu ya miradi binafsi, rejea faili za README katika:
- `quiz-app/README.md` - Programu ya mtihani ya Vue 3
- `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
- `9-chat-project/README.md` - Mradi wa msaidizi wa mazungumzo wa AI
### Muundo wa Monorepo
Ingawa si monorepo ya kawaida, hifadhidata hii ina miradi kadhaa huru:
- Kila somo ni tegemezi la pekee
- Miradi haishiriki tegemezi
Ingawa sio monorepo ya kawaida, hazina hii ina miradi huru mingi:
- Kila somo limejitegemea
- Miradi haishiriki utegemezi
- 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 -->
**Angalizo**:
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.
**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 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 -->
Loading…
Cancel
Save