diff --git a/translations/cs/.co-op-translator.json b/translations/cs/.co-op-translator.json index 5f3049fb6..3ea0512a3 100644 --- a/translations/cs/.co-op-translator.json +++ b/translations/cs/.co-op-translator.json @@ -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" }, diff --git a/translations/cs/AGENTS.md b/translations/cs/AGENTS.md index 736c73225..8c49362b5 100644 --- a/translations/cs/AGENTS.md +++ b/translations/cs/AGENTS.md @@ -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čně -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í postupně +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 adresáří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 adresáří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 --- -**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. \ No newline at end of file diff --git a/translations/hu/.co-op-translator.json b/translations/hu/.co-op-translator.json index e2502e5aa..ff4a810f8 100644 --- a/translations/hu/.co-op-translator.json +++ b/translations/hu/.co-op-translator.json @@ -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" }, diff --git a/translations/hu/AGENTS.md b/translations/hu/AGENTS.md index 67dfa0e07..2d0643d0a 100644 --- a/translations/hu/AGENTS.md +++ b/translations/hu/AGENTS.md @@ -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 -**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. \ No newline at end of file diff --git a/translations/sw/.co-op-translator.json b/translations/sw/.co-op-translator.json index e20fa1958..73db26214 100644 --- a/translations/sw/.co-op-translator.json +++ b/translations/sw/.co-op-translator.json @@ -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" }, diff --git a/translations/sw/AGENTS.md b/translations/sw/AGENTS.md index 7dc324e0b..bc47352df 100644 --- a/translations/sw/AGENTS.md +++ b/translations/sw/AGENTS.md @@ -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 ``` -## 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 kung’olewa 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 --- -**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. \ No newline at end of file