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

pull/1793/head
localizeflow[bot] 5 months ago
parent 2ef3acee53
commit 306cec0f79

@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T18:27:27+00:00", "translation_date": "2026-04-20T16:05:07+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "et" "language_code": "et"
}, },

@ -2,42 +2,42 @@
## Projekti ülevaade ## Projekti ülevaade
See on hariduslik õppekursuse hoidla veebiarenduse põhitõdede õpetamiseks algajatele. Õppekava on Microsoft Cloud Advocatesi poolt välja töötatud põhjalik 12-nädalane kursus, mis sisaldab 24 praktilist õppetundi, katmas JavaScripti, CSSi ja HTMLi. See on hariduslik õppekava hoidla veebiarenduse aluste õpetamiseks algajatele. Õppekava on Microsoft Cloud Advocatesi poolt välja töötatud põhjalik 12-nädalane kursus, mis sisaldab 24 praktilist õppetundi JavaScripti, CSSi ja HTMLi kohta.
### Peamised komponendid ### Peamised komponendid
- **Hariduslik sisu**: 24 struktureeritud õppetundi projektipõhistes moodulites - **Hariduslik sisu**: 24 struktureeritud õppetundi projektipõhistes moodulites
- **Praktilised projektid**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor ja AI Chat Assistant - **Praktilised projektid**: Terrarium, Trükkimismäng, Brauserilaiendus, Kosmosemäng, Pangaäpp, Koodiredaktor ja AI vestlusassistent
- **Interaktiivsed viktoriinid**: 48 viktoriini, igaüks 3 küsimusega (enne ja pärast õppetundi) - **Interaktiivsed viktoriinid**: 48 viktoriini, igaühes 3 küsimust (enne ja pärast õppetundi hindamised)
- **Mitmekeelne tugi**: Automaatne tõlge 50+ keelde GitHub Actions abil - **Mitmekeelne tugi**: 50+ keele automaatne tõlge GitHub Actions abil
- **Tehnoloogiad**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (tehisintellekti projektide jaoks) - **Tehnoloogiad**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI projektide jaoks)
### Arhitektuur ### Arhitektuur
- Hariduslik hoidla õppetundidel põhineva struktuuriga - Hariduslik hoidla õppetundide struktuuriga
- Igas õppetunni kaustas on README, koodinäited ja lahendused - Igas õppetunni kaustas on README, koodinäited ja lahendused
- Isetoimivad projektid eraldi kataloogides (quiz-app, erinevad õppetundide projektid) - Eraldiseisvad projektid eraldi kataloogides (quiz-app, erinevad õppetunniprojektid)
- Tõlkesüsteem, mis kasutab GitHub Actions (co-op-translator) - Tõlkesüsteem GitHub Actions (co-op-translator) abil
- Dokumentatsioon esitatakse Docsify kaudu ja see on saadaval ka PDF-formaadis - Dokumentatsioon esitatakse Docsify kaudu ja on saadaval PDF-formaadis
## Seadistuse käsud ## Paigaldus käsud
See hoidla on peamiselt mõeldud haridusliku sisu tarbimiseks. Spetsiifiliste projektidega töötamiseks: See hoidla on mõeldud peamiselt haridussisu tarbimiseks. Spetsiifiliste projektidega töötamiseks:
### Peamine hoidla seadistamine ### Peamise hoidla seadistamine
```bash ```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners cd Web-Dev-For-Beginners
``` ```
### Viktoriini äpi seadistamine (Vue 3 + Vite) ### Quiz App seadistamine (Vue 3 + Vite)
```bash ```bash
cd quiz-app cd quiz-app
npm install npm install
npm run dev # Käivita arendusserver npm run dev # Käivita arendusserver
npm run build # Koosta tootmiseks npm run build # Ehita tootmiseks
npm run lint # Käivita ESLint npm run lint # Käivita ESLint
``` ```
@ -56,10 +56,10 @@ npm run format # Vorminda Prettieriga
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
npm install npm install
# Järgi brauseri-spetsiifilisi laienduste laadimise juhiseid # Järgige brauserispetsiifilisi laienduse laadimise juhiseid
``` ```
### Space Game projektid ### Kosmosemängu projektid
```bash ```bash
cd 6-space-game/solution cd 6-space-game/solution
@ -67,51 +67,51 @@ npm install
# Ava index.html brauseris või kasuta Live Serverit # Ava index.html brauseris või kasuta Live Serverit
``` ```
### Vestlusprojekti (Python back-end) seadistamine ### Vestlusprojekti tagaplaan (Python)
```bash ```bash
cd 9-chat-project/solution/backend/python cd 9-chat-project/solution/backend/python
pip install openai pip install openai
# Määra GITHUB_TOKEN keskkonnamuutuja # Määra keskkonnamuutuja GITHUB_TOKEN
python api.py python api.py
``` ```
## Arendustöövoog ## Arendustöövoog
### Sisu panustajatele ### Sisuloomele
1. **Forkige hoidla** oma GitHubi kontole 1. **Forki hoidla** oma GitHub kontole
2. **Kloonige oma fork lokaalselt** 2. **Klooni oma fork lokaalselt**
3. **Loo uus haru** oma muudatuste jaoks 3. **Loo uus haru** oma muudatuste jaoks
4. Muutke õppetundide sisu või koodinäiteid 4. Tee muudatusi õppe sisu või koodinäidetes
5. Testige koodi muudatusi vastavates projektikaustades 5. Testi muudatusi vastavates projektikaustades
6. Esitage pull requeste vastavalt panustamise juhistele 6. Esita pull request vastavalt panustamise juhistele
### Õppijatele ### Õppijatele
1. Forkige või kloonige hoidla 1. Forki või klooni hoidla
2. Liikuge järjest õppetundide kataloogidesse 2. Liigu õppetundide kaustades järjekorras
3. Lugege iga õppetunni README faile 3. Loe iga õppetunni README faile
4. Täitke e-viktoriinid aadressil https://ff-quizzes.netlify.app/web/ 4. Täida eelnevad viktoriinid aadressil https://ff-quizzes.netlify.app/web/
5. Töötage läbi õppetundide koodinäited 5. Töötle läbi õppetunni koodinäited
6. Täitke ülesanded ja väljakutsed 6. Täida ülesanded ja väljakutsed
7. Sooritage pärast õppetundi viktoriinid 7. Tee lõppviktoriinid
### Otse arendus ### Reaalajas arendus
- **Dokumentatsioon**: Käivitage `docsify serve` juurkataloogis (port 3000) - **Dokumentatsioon**: käivita juurkataloogis `docsify serve` (port 3000)
- **Viktoriini äpp**: Käivitage `npm run dev` quiz-app kaustas - **Quiz App**: käivita `npm run dev` quiz-app kataloogis
- **Projektid**: Kasutage VS Code Live Serveri laiendust HTML projektide jaoks - **Projektid**: kasuta VS Code Live Server laiendust HTML projektide jaoks
- **API projektid**: Käivitage `npm start` vastavates API kaustades - **API projektid**: käivita vastavates API kaustades `npm start`
## Testimise juhised ## Testimisjuhised
### Viktoriini äpi testimine ### Quiz App testimine
```bash ```bash
cd quiz-app cd quiz-app
npm run lint # Kontrolli koodistiili probleeme npm run lint # Kontrolli koodistiili probleeme
npm run build # Kontrolli, et ehitus õnnestub npm run build # Kontrolli, kas ehitus õnnestub
``` ```
### Panga API testimine ### Panga API testimine
@ -119,144 +119,144 @@ npm run build # Kontrolli, et ehitus õnnestub
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm run lint # Kontrolli koodi stiiliprobleeme npm run lint # Kontrolli koodi stiiliprobleeme
node server.js # Kontrolli, et server algab ilma vigadeta node server.js # Kontrolli, et server käivitub ilma vigadeta
``` ```
### Üldine testimislähenemine ### Üldine testimisviis
- Tegevhoidla ilma põhjalike automaattestideta - See on hariduslik hoidla ilma põhjalike automatiseeritud testideta
- Manuaaltestimine keskendub: - Käsitsi testimine keskendub:
- Koodinäidete korrektsele käivitumisele - Koodinäited töötavad ilma vigadeta
- Dokumentatsiooni linkide toimimisele - Dokumentatsiooni lingid töötavad korrektselt
- Projektide koostamise edukusele - Projektide ehitused õnnestuvad
- Näidete parimate tavade järgimisele - Näited järgivad parimaid tavasid
### Enne esitamist tehtavad kontrollid ### Enne esitamist kontroll
- Käivitage `npm run lint` kaustades, kus on package.json - Käivita kataloogides, kus on package.json, `npm run lint`
- Kontrollige, et markdowni lingid oleksid korrektsed - Kontrolli markdown linkide korrasolekut
- Testige koodinäiteid brauseris või Node.js-is - Testi koodinäiteid brauseris või Node.js-s
- Kontrollige, et tõlked säilitavad nõuetekohase struktuuri - Veendu, et tõlked säilitavad õige struktuuri
## Koodi stiili juhised ## Koodi stiili juhised
### JavaScript ### JavaScript
- Kasutage kaasaegset ES6+ süntaksit - Kasuta kaasaegset ES6+ süntaksit
- Järgige standardseid ESLint konfiguratsioone projektides - Järgi projektides olevaid standardseid ESLint konfiguratsioone
- Kasutage tähenduslikke muutujate ja funktsioonide nimesid hariduslikuks selguseks - Kasuta tähenduslikke muutujate ja funktsioonide nimesid selguse huvides
- Lisage kommentaare kontseptsioonide selgitamiseks õppijatele - Lisa kommentaare, mis selgitavad mõisteid õppijatele
- Kasutage vormindamiseks, kus seadistatud, Prettierit - Vorminda koodi Prettieriga, kus see on seadistatud
### HTML/CSS ### HTML/CSS
- Semantilised HTML5 elemendid - Semantiline HTML5 elementide kasutus
- Reageeriv disain - Reageeriv disainiprintsiip
- Selged klassinimede konventsioonid - Selged klassinimede reeglid
- Kommentaarid CSS tehnikate selgitamiseks õppijatele - Kommentaarid, mis selgitavad CSS tehnikaid õppijatele
### Python ### Python
- PEP 8 stiilijuhised - Järgi PEP 8 stiilijuhiseid
- Selged, harivad koodinäited - Selged ja hariduslikud koodinäited
- Tippimisvihjed õppimise hõlbustamiseks - Kasuta tüübiviiteid, kus õppimiseks kasulik
### Markdown dokumentatsioon ### Markdown dokumentatsioon
- Selge pealkirjade hierarhia - Selge pealkirjade hierarhia
- Koodiplokid koos keele määratlusega - Koodiplokid koos keelespetsifikatsiooniga
- Lingid lisamaterjalidele - Lingid lisamaterjalidele
- Ekraanipildid ja pildid `images/` kataloogides - Ekraanipildid ja pildid `images/` kaustades
- Ligipääsetavuse huvides piltide alt-tekstid - Piltide jaoks alternatiivtekst ligipääsetavuse tagamiseks
### Failide korraldus ### Failide organiseerimine
- Õppetunnid nummerdatud järjest (1-getting-started-lessons, 2-js-basics jne) - Õppetunnid nummerdatud järjestikku (1-getting-started-lessons, 2-js-basics jne)
- Igal projektil on `solution/` ja sageli ka `start/` või `your-work/` kaustad - Igal projektil on `solution/` ja sageli `start/` või `your-work/` kaustad
- Pildid talletatud õppetundidele spetsiifilistes `images/` kaustades - Pildid salvestatud õppetundide spetsiifilistesse `images/` kaustadesse
- Tõlked paigutatud `translations/{language-code}/` kataloogistruktuuri - Tõlked `translations/{language-code}/` struktuuris
## Koostamine ja juurutamine ## Ehitamine ja juurutamine
### Viktoriini äpi juurutamine (Azure Static Web Apps) ### Quiz App juurutamine (Azure Static Web Apps)
Quiz-app on seadistatud Azure Static Web Apps juurutuseks: Quiz-app on konfigureeritud Azure Static Web Apps juurutamiseks:
```bash ```bash
cd quiz-app cd quiz-app
npm run build # Loob kausta dist/ npm run build # Loob dist/ kausta
# Käivitab GitHub Actionsi töövoo, kui tehakse push main harusse # Paigaldab GitHub Actions töövoo kaudu, kui tehakse push main harusse
``` ```
Azure Static Web Apps konfiguratsioon: Azure Static Web Apps konfiguratsioon:
- **Rakenduse asukoht**: `/quiz-app` - **Rakenduse asukoht**: `/quiz-app`
- **Väljundi asukoht**: `dist` - **Väljundasukoht**: `dist`
- **Töövoog**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` - **Töövoog**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Dokumentatsiooni PDF genereerimine ### Dokumentatsiooni PDF genereerimine
```bash ```bash
npm install # Installi docsify-to-pdf npm install # Paigalda docsify-to-pdf
npm run convert # Loo PDF docsist npm run convert # Genereeri PDF docsist
``` ```
### Docsify dokumentatsioon ### Docsify dokumentatsioon
```bash ```bash
npm install -g docsify-cli # Paigalda Docsify globaalselt npm install -g docsify-cli # Paigalda Docsify ülemaailmselt
docsify serve # Serveeri aadressil localhost:3000 docsify serve # Serveeri aadressil localhost:3000
``` ```
### Projektipõhised ehitused ### Projekti-spetsiifilised ehitused
Igal projekti kaustal võib olla oma ehitusprotsess: Igal projekti kaustal võib olla oma ehitusprotsess:
- Vue projektid: `npm run build` loob tootmisversiooni pakette - Vue projektid: `npm run build` loob tootmispaketid
- Staatilised projektid: ehitusfaasi pole, failid serveeritakse otse - Staatilised projektid: eraldi ehitusetappi ei ole, faile serveeritakse otse
## Pull requesti juhised ## Pull requesti juhised
### Pealkirja formaat ### Pealkirja formaat
Kasutage selgeid, kirjeldavaid pealkirju, mis näitavad muudatuste valdkonda: Kasuta selgeid ja kirjeldavaid pealkirju, mis näitavad muudatuse valdkonda:
- `[Quiz-app] Lisa uus viktoriin õppetunnile X` - `[Quiz-app] Lisa uus viktoriin õppetunnile X`
- `[Lesson-3] Paranda kirjaviga terrarium projektis` - `[Lesson-3] Paranda kirjaviga terrarium projekti juures`
- `[Translation] Lisa hispaania tõlge õppetunnile 5` - `[Translation] Lisa hispaania tõlge õppetunnile 5`
- `[Docs] Uuenda seadistusjuhiseid` - `[Docs] Uuenda paigaldusjuhiseid`
### Nõutavad kontrollid ### Nõutavad kontrollid
Enne PR-i esitamist: Enne PR-i esitamist:
1. **Koodi kvaliteet**: 1. **Koodi kvaliteet**:
- Käivitage `npm run lint` mõjutatud projektikaustades - Käivita mõjutatud projektikaustades `npm run lint`
- Parandage kõik lintimisvead ja hoiatused - Paranda kõik lintimise vead ja hoiatused
2. **Ehituskontroll**: 2. **Ehituse kontroll**:
- Käivitage `npm run build`, kui see on asjakohane - Käivita `npm run build`, kui see kehtib
- Veenduge, et ehitusvead puuduvad - Veendu, et ehitus ei anna vigu
3. **Linkide valideerimine**: 3. **Linkide kontroll**:
- Kontrollige kõiki markdowni linke - Testi kõiki markdown linke
- Veenduge, et pildiviited töötavad - Kontrolli pildi viidete toimimist
4. **Sisukontroll**: 4. **Sisu ülevaade**:
- Oikige õigekirja ja grammatika - Tee õigekirja ja grammatika ülevaade
- Veenduge, et koodinäited on korrektsed ja harivad - Veendu, et koodinäited on korrektsed ja hariduslikud
- Kontrollige, et tõlked säilitavad algse tähenduse - Kontrolli, et tõlked säilitavad algse tähenduse
### Panustamise nõuded ### Panustamise nõuded
- Nõustuge Microsofti CLA-ga (automatiseeritud kontroll esimese PR-i puhul) - Nõustu Microsoft CLA-ga (automaatselt esimese PR-i juures)
- Järgige [Microsoft Open Source käitumiskoodeksit](https://opensource.microsoft.com/codeofconduct/) - Järgi [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Lisateave panustamise kohta on [CONTRIBUTING.md](./CONTRIBUTING.md) - Vaata [CONTRIBUTING.md](./CONTRIBUTING.md) üksikasjalike juhiste jaoks
- Tõstke PR kirjelduses esile seotud issue numbrid, kui asjakohane - Viita PR kirjelduses vajadusel issue numbritele
### Käsitlusprotsess ### Ülevaatusprotsess
- PR-id vaatavad üle hoidla hooldajad ja kogukond - PR-e vaatavad läbi hoidla hooldajad ja kogukond
- Eelistatakse hariduslikku selgust - Eesmärk on haridusliku selguse tagamine
- Koodinäited peaksid järgima parimaid tavasid - Koodinäited peavad järgima parimaid tänaseid tavasid
- Tõlked vaadatakse üle täpsuse ja kultuurilise sobivuse osas - Tõlked üle vaadatakse täpsuse ja kultuurilise sobivuse osas
## Tõlkesüsteem ## Tõlkesüsteem
@ -264,19 +264,19 @@ Enne PR-i esitamist:
- Kasutab GitHub Actions koos co-op-translator töövooga - Kasutab GitHub Actions koos co-op-translator töövooga
- Tõlgib automaatselt 50+ keelde - Tõlgib automaatselt 50+ keelde
- Allikafailid on peakaustades - Algfailid peamistest kataloogidest
- Tõlgitud failid asuvad `translations/{language-code}/` kataloogides - Tõlgitud failid `translations/{language-code}/` kataloogides
### Käsitsi tõlke paranduste lisamine ### Käsitsi tõlkete parandused
1. Leidke fail `translations/{language-code}/` 1. Leia fail `translations/{language-code}/` kataloogis
2. Tehke parandusi, säilitades struktuuri 2. Tee parandused, hoides struktuuri muutumatuna
3. Veenduge, et koodinäited töötavad jätkuvalt 3. Veendu, et koodinäited jäävad toimima
4. Testige kohalikku viktoriini sisu 4. Testi lokaliseeritud viktoriini sisu
### Tõlke metaandmed ### Tõlke metaandmed
Tõlgitud failid sisaldavad metaandmete päist: Tõlgitud failidel on metaandmete päis:
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
--> -->
``` ```
## Silumine ja tõrkeotsing ## Silumine ja probleemide lahendamine
### Levinud probleemid ### Levinud probleemid
**Viktoriini äpp ei käivitu**: **Quiz app ei käivitu**:
- Kontrollige Node.js versiooni (soovitav v14+) - Kontrolli Node.js versiooni (soovituslik v14+)
- Kustutage `node_modules` ja `package-lock.json`, käivitage uuesti `npm install` - Kustuta `node_modules` ja `package-lock.json`, käivita uuesti `npm install`
- Kontrollige portide konflikte (vaikimisi kasutab Vite porti 5173) - Kontrolli portide konflikte (vaikimisi: Vite kasutab porti 5173)
**API server ei käivitu**: **API server ei käivitu**:
- Kontrollige, et Node.js versioon vastab nõuetele (node >=10) - Kontrolli, et Node.js versioon on minimaalne (node >=10)
- Kontrollige, kas port on juba kasutuses - Veendu, et port ei ole juba kasutusel
- Veenduge, et kõik sõltuvused on installitud `npm install` abil - Kontrolli, et kõik sõltuvused on paigaldatud `npm install` abil
**Brauserilaiend ei laadi**: **Brauserilaiend ei laaditu**:
- Kontrollige, et manifest.json on korrektselt vormindatud - Kontrolli, et manifest.json on korrektselt vormindatud
- Vaadake brauseri konsoolist veateateid - Vaata brauseri konsooli vigade jaoks
- Järgige brauseripõhiseid laiendi installi juhiseid - Järgi brauserispetsiifilisi laienduste paigaldusjuhiseid
**Python vestlusprojekti probleemid**: **Python vestlusprojekti probleemid**:
- Veenduge, et OpenAI pakett on installitud: `pip install openai` - Veendu, et OpenAI pakett on paigaldatud: `pip install openai`
- Kontrollige, et GITHUB_TOKEN keskkonnamuutuja on seadistatud - Kontrolli, et GITHUB_TOKEN keskkonnamuutuja on määratud
- Kontrollige GitHub Models'i ligipääsuõigusi - Vaata GitHub Models juurde pääsemise õigusi
**Docsify ei serveeri dokumente**: **Docsify ei serveeri dokumente**:
- Paigaldage globaalne docsify-cli: `npm install -g docsify-cli` - Paigalda docsify-cli globaalset: `npm install -g docsify-cli`
- Käivitage hoidla juurkataloogist - Käivita hoidla juurkataloogist
- Kontrollige, et `docs/_sidebar.md` fail on olemas - Veendu, et `docs/_sidebar.md` fail on olemas
### Arenduskeskkonna näpunäiteid ### Arenduskeskkonna nõuanded
- Kasutage VS Code'i koos Live Server laiendusega HTML projektide jaoks - Kasuta VS Code Live Server laiendust HTML projektide jaoks
- Paigaldage ESLint ja Prettier laiendused ühtlaseks vormindamiseks - Paigalda ESLint ja Prettier laiendused konsistentseks vormindamiseks
- Kasutage brauseri DevToolsi JavaScripti silumiseks - Kasuta brauseri DevTools JavaScripti silumiseks
- Vue projektide jaoks paigaldage Vue DevTools brauserilaiend - Vue projektide jaoks installi Vue DevTools brauserilaiendus
### Jõudluse kaalutlused ### Tulemuslikkuse kaalutlused
- Suurem hulk tõlgitud faile (50+ keelt) teeb täiskloonid mahukaks - Suur hulk tõlgitud faile (50+ keelt) teeb täielikud kloonid mahukaks
- Kasutage ülasidumist, kui töötate ainult sisuga: `git clone --depth 1` - Kasuta sumbunud klooni, kui töötad ainult sisuga: `git clone --depth 1`
- Välistage tõlked ingliskeelse sisuga töötades otsingutest - Väldi tõlgete otsinguid, kui töötad ingliskeelse sisuga
- Esimene kord võivad ehitusprotsessid olla aeglased (npm install, Vite build) - Ehitusteenused võivad esimesel käivitamisel olla aeglased (npm install, Vite build)
## Turvalisuse kaalutlused ## Turvanõuded
### Keskkonnamuutujad ### Keskkonnamuutujad
- API võtit ei tohi kunagi hoidlas hoida - API võtmeid ei tohi kunagi hoidlas hoida
- Kasutage `.env` faile (juba `.gitignore`-s) - Kasuta `.env` faile (mida on juba `.gitignore`-s)
- Dokumenteerige vajalikud keskkonnamuutujad projekti README-des - Dokumenteeri vajalikud keskkonnamuutujad projektide README-des
### Python projektid ### Python projektid
- Kasutage virtuaalset keskkonda: `python -m venv venv` - Kasuta virtuaalkeskkonda: `python -m venv venv`
- Hoidke sõltuvused uuendatud - Hoia sõltuvused värskendatud
- GitHubi tokenitel peaks olema minimaalne nõutav ligipääs - GitHub tokenitel peaksid olema minimaalsed õigused
### GitHub Models ligipääs ### GitHub Models ligipääs
- Isiklikud ligipääsu tokenid (PAT) on vajalikud GitHub Models'ile - Isiklikud ligipääsu tokenid (PAT) on vajalikud GitHub Models jaoks
- Tokenid tuleks hoida keskkonnamuutujatena - Tokenid salvestada keskkonnamuutujatena
- Ärge kunagi pange tokeneid või kasutajatunnuseid hoidlasse - Tokenid ega mandaadid ei tohi kunagi hoidlasse jõuda
## Lisamärkused ## Lisamärkused
### Sihtgrupp ### Sihtgrupp
- Täielikud algajad veebiarenduses - Täielikud algajad veebiarenduses
- Õpilased ja isetegijad - Õpilased ja iseseisvad õppijad
- Õpetajad, kes kasutavad õppekava klassiruumis - Õpetajad, kes kasutavad õppekava klassiruumis
- Sisu on loodud ligipääsetavaks ja oskuste järkjärguliseks kujundamiseks - Sisu on loodud ligipääsetavaks ja samm-sammuliseks oskuste kasvatamiseks
### Hariduslik filosoofia ### Haridusfilosoofia
- Projektipõhine õppe lähenemine - Projektipõhine õppimisviis
- Sageli tehtavad teadmiste kontrollid (viktoriinid) - Sageli teadmiste kontrollid (viktoriinid)
- Praktiseerivad kodeerimisülesanded - Praktiseerivad kodeerimise harjutused
- Reaalsete rakenduste näited - Reaalsed näited rakendustest
- Fookus põhitalitustel enne raamistikke - Keskendutakse alustele enne raamistikke
### Hoidla hooldus ### Hoidla hooldus
- Aktiivne kogukond õppijate ja panustajatega - Aktiivne õppijate ja panustajate kogukond
- Sõltuvuste ja sisu regulaarne uuendamine - Regulaarne sõltuvuste ja sisu uuendamine
- Hoiuluründed ja arutelud hooldajate poolt jälgitavad - Probleemid ja arutelud hooldajate jälgimisel
- Tõlkeuuendused automatiseeritud GitHub Actions abil - Tõlkeuuendused automatiseeritud GitHub Actions kaudu
### Seotud ressursid ### Seotud ressursid
- [Microsoft Learn moodulid](https://docs.microsoft.com/learn/) - [Microsoft Learn moodulid](https://docs.microsoft.com/learn/)
- [Student Hub ressursid](https://docs.microsoft.com/learn/student-hub/) - [Student Hub ressursid](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) soovitatav õppijatele - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) soovitatav õppijatele
- Täiendavad kursused: Generative AI, Data Science, ML, IoT õppekavad saadaval - Täiendavad kursused: Generatiivne AI, Andmeteadus, ML, IoT õppekavad saadaval
### Spetsiaalprojektidega töötamine ### Töö spetsiifiliste projektidega
Üksikute projektide üksikasjalike juhiste jaoks vt README faile: Detailseid juhiseid üksikute projektide jaoks leiad nende README failidest:
- `quiz-app/README.md` - Vue 3 viktoriini rakendus - `quiz-app/README.md` - Vue 3 viktoriini rakendus
- `7-bank-project/README.md` - Pangarakendus autentimisega - `7-bank-project/README.md` - Pangarakendus autentimisega
- `5-browser-extension/README.md` - Brauserilaiendi arendamine - `5-browser-extension/README.md` - Brauserilaienduse arendus
- `6-space-game/README.md` - Canvas-põhine mänguarendus - `6-space-game/README.md` - Canvas-põhine mänguarendus
- `9-chat-project/README.md` - AI vestlusabilise projekt - `9-chat-project/README.md` - AI vestlusassistiendi projekt
### Monorepo struktuur ### Monorepo struktuur
Kuigi ei ole traditsiooniline monorepo, sisaldab see hoidla mitut sõltumatut projekti: Kuigi see ei ole traditsiooniline monorepo, sisaldab see hoidla mitmeid iseseisvaid projekte:
- Iga õppetund on iseseisev - Iga õppetund on eraldiseisev
- Projektid ei jaga sõltuvusi - Projektid ei jaga sõltuvusi
- Töötage üksikute projektidega mõjutamata teisi - Töötada saab üksikute projektidega mõjutamata teisi
- Kloonige kogu hoidla kogu õppekava kogemuse saamiseks - Klooni kogu hoidla tervikliku õppekava kogemiseks
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Vastutusest vabastamine**: **Vastutusest loobumine**:
Seda dokumenti on tõlgitud kasutades AI tõlketeenust [Co-op Translator](https://github.com/Azure/co-op-translator). Kuigi me püüdleme täpsuse poole, olge teadlik, et automaatsed tõlked võivad sisaldada vigu või ebatäpsusi. Originaaldokument selle emakeeles tuleks pidada autoriteetseks allikaks. Tähtsa teabe puhul soovitatakse kasutada professionaalset inimtõlget. Me ei vastuta ühegi arusaamatuse ega tõlgenduse eest, mis võivad tuleneda selle tõlke kasutamisest. See dokument on tõlgitud kasutades tehisintellekti tõlketeenust [Co-op Translator](https://github.com/Azure/co-op-translator). Kuigi me püüame täpsust, palun arvestage, et automaatsed tõlked võivad sisaldada vigu või ebatäpseid osi. Originaaldokument selle emakeeles tuleks pidada autoriteetseks allikaks. Olulise teabe puhul soovitatakse kasutada professionaalset inimtõlget. Me ei vastuta selle tõlke kasutamisest tingitud arusaamatuste ega väärarusaamade eest.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T18:28:16+00:00", "translation_date": "2026-04-20T16:06:12+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "pcm" "language_code": "pcm"
}, },

@ -2,11 +2,11 @@
## Project Overview ## Project Overview
Dis na educational curriculum repository wey teach web development fundamentals to beginners. Di curriculum na full 12-week course wey Microsoft Cloud Advocates develop, get 24 hands-on lessons wey cover JavaScript, CSS, and HTML. Dis na wan educational curriculum repository wey dem dey use teach web development fundamentals to beginners. Di curriculum na big 12-week course wey Microsoft Cloud Advocates make, get 24 hands-on lessons covering JavaScript, CSS, and HTML.
### Key Components ### Key Components
- **Educational Content**: 24 arranged lessons wey follow project-based modules - **Educational Content**: 24 structured lessons wey dem organize inside project-based modules
- **Practical Projects**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, and AI Chat Assistant - **Practical Projects**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, and AI Chat Assistant
- **Interactive Quizzes**: 48 quizzes wey get 3 questions each (pre/post-lesson assessments) - **Interactive Quizzes**: 48 quizzes wey get 3 questions each (pre/post-lesson assessments)
- **Multi-language Support**: Automated translations for 50+ languages through GitHub Actions - **Multi-language Support**: Automated translations for 50+ languages through GitHub Actions
@ -14,15 +14,15 @@ Dis na educational curriculum repository wey teach web development fundamentals
### Architecture ### Architecture
- Educational repository with lesson-based structure - Educational repository wey get lesson-based structure
- Each lesson folder get README, code examples, and solutions - Every lesson folder get README, code examples, and solutions
- Standalone projects for different directories (quiz-app, various lesson projects) - Standalone projects dey for separate directories (quiz-app, various lesson projects)
- Translation system dey use GitHub Actions (co-op-translator) - Translation system dey use GitHub Actions (co-op-translator)
- Documentation dey serve via Docsify and e dey available as PDF - Documentation dey serve through Docsify and e dey available as PDF
## Setup Commands ## Setup Commands
Dis repository na mainly for educational content consumption. If you wan work with specific projects: Dis repository na mainly for educational content consumption. For to work with specific projects:
### Main Repository Setup ### Main Repository Setup
@ -46,7 +46,7 @@ npm run lint # Run ESLint
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm install npm install
npm start # Start di API server npm start # Start API server
npm run lint # Run ESLint npm run lint # Run ESLint
npm run format # Format wit Prettier npm run format # Format wit Prettier
``` ```
@ -81,28 +81,28 @@ python api.py
### For Content Contributors ### For Content Contributors
1. **Fork di repository** go your GitHub account 1. **Fork di repository** go your GitHub account
2. **Clone your fork** for your local machine 2. **Clone your fork** for your machine
3. **Create new branch** for your changes 3. **Create new branch** for your changes
4. Make changes to lesson content or code examples 4. Make changes for lesson content or code examples
5. Test any code changes for correct project directories 5. Test any code changes inside the relevant project directories
6. Submit pull requests wey follow contribution guidelines 6. Submit pull requests based on contribution guidelines
### For Learners ### For Learners
1. Fork or clone di repository 1. Fork or clone di repository
2. Go lesson directories one by one 2. Go through lesson directories one by one
3. Read README files for each lesson 3. Read README files for each lesson
4. Do pre-lesson quizzes for https://ff-quizzes.netlify.app/web/ 4. Do pre-lesson quizzes at https://ff-quizzes.netlify.app/web/
5. Work through code examples inside lesson folders 5. Work through code examples inside lesson folders
6. Complete assignments and challenges 6. Finish assignments and challenges
7. Take post-lesson quizzes 7. Do post-lesson quizzes
### Live Development ### Live Development
- **Documentation**: Run `docsify serve` for root (port 3000) - **Documentation**: Run `docsify serve` for root (port 3000)
- **Quiz App**: Run `npm run dev` for quiz-app directory - **Quiz App**: Run `npm run dev` inside quiz-app directory
- **Projects**: Use VS Code Live Server extension for HTML projects - **Projects**: Use VS Code Live Server extension for HTML projects
- **API Projects**: Run `npm start` for respective API directories - **API Projects**: Run `npm start` for the API directories
## Testing Instructions ## Testing Instructions
@ -111,81 +111,81 @@ python api.py
```bash ```bash
cd quiz-app cd quiz-app
npm run lint # Check for code style wahala npm run lint # Check for code style wahala
npm run build # Make sure say build dey succeed npm run build # Make sure build dey successful
``` ```
### Bank API Testing ### Bank API Testing
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm run lint # Check if code style get wahala npm run lint # Check for code style wahala
node server.js # Make sure server start without yawa node server.js # Make sure say server fit start without any kasala
``` ```
### General Testing Approach ### General Testing Approach
- Dis na educational repository wey no get full automated tests - Dis na educational repository wey no get full automatic tests
- Manual testing focus on: - Manual testing dey focus on:
- Code examples dey run without error - Code examples dey run without wahala
- Links for documentation dey work well - Links for documentation dey work well
- Project builds dey complete successful - Project build dey complete successful
- Examples dey follow best practices - Examples follow best practices
### Pre-submission Checks ### Pre-submission Checks
- Run `npm run lint` for directories wey get package.json - Run `npm run lint` for directories wey get package.json
- Check say markdown links valid - Check say markdown links dey valid
- Test code examples for browser or Node.js - Test code examples for browser or Node.js
- Confirm translations get proper structure - Confirm say translations keep correct structure
## Code Style Guidelines ## Code Style Guidelines
### JavaScript ### JavaScript
- Use modern ES6+ syntax - Use modern ES6+ syntax
- Follow standard ESLint configurations from projects - Follow standard ESLint config wey projects get
- Use meaningful variable and function names to help learners understand - Use meaningful variable and function names for educational clarity
- Add comments to explain concepts for learners - Add comments wey explain concepts for learners
- Format using Prettier where e dey configured - Format using Prettier if e dey setup
### HTML/CSS ### HTML/CSS
- Use semantic HTML5 elements - Use semantic HTML5 elements
- Responsive design principles - Responsive design principles
- Clear class naming conventions - Clear class naming conventions
- Comments to explain CSS techniques well for learners - Comments wey dey explain CSS techniques for learners
### Python ### Python
- Follow PEP 8 style guidelines - PEP 8 style guidelines
- Clear, educational code examples - Clear, educational code examples
- Put type hints where e dey useful for learning - Type hints where e go help learning
### Markdown Documentation ### Markdown Documentation
- Clear heading hierarchy - Clear heading hierarchy
- Code blocks wey specify language - Code blocks with language specification
- Links to more resources - Links to extra resources
- Screenshots and images for `images/` directories - Screenshots and images inside `images/` directories
- Alt text for images to support accessibility - Alt text for images to support accessibility
### File Organization ### File Organization
- Lessons dey number sequentially (1-getting-started-lessons, 2-js-basics, etc.) - Lessons dey numbered one by one (1-getting-started-lessons, 2-js-basics, etc.)
- Every project get `solution/` and normally `start/` or `your-work/` directories - Every project get `solution/` and sometimes `start/` or `your-work/` directories
- Images dey inside lesson-specific `images/` folders - Images for lesson-specific `images/` folders
- Translations dey in `translations/{language-code}/` folders - Translations dey inside `translations/{language-code}/` structure
## Build and Deployment ## Build and Deployment
### Quiz App Deployment (Azure Static Web Apps) ### Quiz App Deployment (Azure Static Web Apps)
Quiz-app dey ready for Azure Static Web Apps deployment: The quiz-app dey configured for Azure Static Web Apps deployment:
```bash ```bash
cd quiz-app cd quiz-app
npm run build # Dey create dist/ folder npm run build # Dey create dist/ folder
# Dey deploy through GitHub Actions workflow when you push for main branch # Dey put for ground wit GitHub Actions workflow wen dem push for main
``` ```
Azure Static Web Apps configuration: Azure Static Web Apps configuration:
@ -203,21 +203,21 @@ npm run convert # Make PDF from docs
### Docsify Documentation ### Docsify Documentation
```bash ```bash
npm install -g docsify-cli # Install Docsify for everywhere npm install -g docsify-cli # Install Docsify all over di system
docsify serve # Make e dey run for localhost:3000 docsify serve # Run for localhost:3000
``` ```
### Project-specific Builds ### Project-specific Builds
Each project fit get him own build process: Every project directory fit get their own build process:
- Vue projects: Run `npm run build` to create production bundles - Vue projects: `npm run build` dey create production bundles
- Static projects: No build step, serve files directly - Static projects: No build step, just serve files directly
## Pull Request Guidelines ## Pull Request Guidelines
### Title Format ### Title Format
Use clear, descriptive titles wey show wetin you change: Use clear, descriptive titles wey show wetin change be:
- `[Quiz-app] Add new quiz for lesson X` - `[Quiz-app] Add new quiz for lesson X`
- `[Lesson-3] Fix typo for terrarium project` - `[Lesson-3] Fix typo for terrarium project`
- `[Translation] Add Spanish translation for lesson 5` - `[Translation] Add Spanish translation for lesson 5`
@ -228,51 +228,51 @@ Use clear, descriptive titles wey show wetin you change:
Before you submit PR: Before you submit PR:
1. **Code Quality**: 1. **Code Quality**:
- Run `npm run lint` for each project directory wey changes affect - Run `npm run lint` for the project directories wey e concern
- Fix all lint errors and warnings - Fix all lint errors and warnings
2. **Build Verification**: 2. **Build Verification**:
- Run `npm run build` if e dey necessary - Run `npm run build` if e necessary
- Make sure no build errors - Make sure no build errors
3. **Link Validation**: 3. **Link Validation**:
- Test all markdown links - Test all markdown links
- Confirm image references dey work - Confirm image refs work
4. **Content Review**: 4. **Content Review**:
- Check for spelling and grammar mistakes - Proofread for spelling and grammar
- Confirm code examples dey correct and educational - Ensure code examples correct and educational
- Make sure translations maintain correct meaning - Confirm translations keep original meaning
### Contribution Requirements ### Contribution Requirements
- You must agree to Microsoft CLA (automatic check for first PR) - Agree to Microsoft CLA (automatic check for first PR)
- Follow the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) - Follow [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- See [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed rules - See [CONTRIBUTING.md](./CONTRIBUTING.md) for details
- Reference issue numbers for PR description if e relate - Reference issue numbers for PR description if e get
### Review Process ### Review Process
- Maintainers and community go review PRs - PRs go through maintainer and community review
- Educational clarity dey priority - Educational clarity dey important
- Code examples suppose follow current best practice - Code examples suppose follow current best practices
- Translations go review for accuracy and cultural fit - Translations go through accuracy and cultural appropriateness check
## Translation System ## Translation System
### Automated Translation ### Automated Translation
- Dey use GitHub Actions with co-op-translator workflow - Dey use GitHub Actions with co-op-translator workflow
- Translates automatically to 50+ languages - Translates to 50+ languages automatically
- Source files dey main directories - Source files dey main directories
- Translated files dey `translations/{language-code}/` folders - Translated files dey inside `translations/{language-code}/`
### Adding Manual Translation Improvements ### Adding Manual Translation Improvements
1. Find the file for `translations/{language-code}/` 1. Find file for `translations/{language-code}/`
2. Make improvements without changing structure 2. Make improvements but keep structure intact
3. Check say code examples still dey work 3. Make sure code examples still dey run well
4. Test localized quiz content 4. Test any quiz content wey localized
### Translation Metadata ### Translation Metadata
@ -293,99 +293,99 @@ CO_OP_TRANSLATOR_METADATA:
### Common Issues ### Common Issues
**Quiz app no dey start**: **Quiz app no fit start**:
- Check Node.js version (v14+ na better) - Check Node.js version (v14+ recommended)
- Delete `node_modules` and `package-lock.json`, run `npm install` again - Delete `node_modules` and `package-lock.json`, run `npm install` again
- Check for port wahala (Vite by default dey use port 5173) - Check for port wahala (default: Vite dey use port 5173)
**API server no dey start**: **API server no go start**:
- Make sure Node.js version dey ok (node >=10) - Confirm Node.js version dey at least (node >=10)
- Check if port dey busy - Check if port don already dey use
- Confirm say all dependencies install with `npm install` - Make sure all dependencies install with `npm install`
**Browser extension no dey load**: **Browser extension no go load**:
- Check manifest.json format correct - Confirm manifest.json format correct
- Check browser console for errors - Check browser console for errors
- Follow browser-specific extension installation guide - Follow browser extension installation instructions
**Python chat project problems**: **Python chat project wahala**:
- Make sure OpenAI package install: `pip install openai` - Confirm OpenAI package install: `pip install openai`
- Confirm GITHUB_TOKEN environment variable dey set - Confirm GITHUB_TOKEN environment variable set
- Check GitHub Models access permissions - Check GitHub Models permission
**Docsify no dey serve docs**: **Docsify no dey serve docs**:
- Install docsify-cli globally: `npm install -g docsify-cli` - Install docsify-cli globally: `npm install -g docsify-cli`
- Run am from repository root folder - Run am from root directory
- Check that `docs/_sidebar.md` dey - Check say `docs/_sidebar.md` dey
### Development Environment Tips ### Development Environment Tips
- Use VS Code with Live Server extension for HTML projects - Use VS Code with Live Server extension for HTML projects
- Install ESLint and Prettier extensions for uniform formatting - Install ESLint and Prettier extensions for proper formatting
- Use browser DevTools for debugging JavaScript - Use browser DevTools for JavaScript debugging
- For Vue projects, install Vue DevTools browser extension - For Vue projects, install Vue DevTools browser extension
### Performance Considerations ### Performance Considerations
- Plenty translated files (50+ languages) mean clone go big - Plenty translated files (50+ languages) mean big clones
- Use shallow clone if you just want content: `git clone --depth 1` - Use shallow clone if na content only: `git clone --depth 1`
- When you dey work on English content, exclude translations from search - Exclude translations from searches if you dey focus on English
- Build fit take time first time (npm install, Vite build) - Build steps fit slow for first time (npm install, Vite build)
## Security Considerations ## Security Considerations
### Environment Variables ### Environment Variables
- API keys no suppose enter repository commit - API keys no suppose commit to repository
- Use `.env` files (dem already inside `.gitignore`) - Use `.env` files (already for `.gitignore`)
- Document environment variables wey project need for README - Document needed environment variables inside project READMEs
### Python Projects ### Python Projects
- Use virtual environments: `python -m venv venv` - Use virtual environments: `python -m venv venv`
- Keep dependencies up to date - Keep dependencies updated
- GitHub tokens get to get smallest necessary permissions - GitHub tokens need minimal permissions
### GitHub Models Access ### GitHub Models Access
- Personal Access Tokens (PAT) dey needed for GitHub Models - Personal Access Tokens (PAT) required for GitHub Models
- Keep tokens as environment variables - Tokens suppose dey stored as environment variables
- No ever commit tokens or credentials - Never commit tokens or credentials
## Additional Notes ## Additional Notes
### Target Audience ### Target Audience
- Complete beginners wey dey learn web development - Complete beginners to web development
- Students and people wey dey learn by themselves - Students and self-learners
- Teachers wey dey use curriculum for classroom - Teachers wey use the curriculum for classroom
- Content designed for accessibility and gradual skill building - Content dey designed for accessibility and gradual skill building
### Educational Philosophy ### Educational Philosophy
- Project-based learning style - Project-based learning style
- Frequent knowledge checks (quizzes) - Frequent knowledge checks (quizzes)
- Hands-on coding exercises - Hands-on coding exercises
- Real-world application examples - Real-life application examples
- Focus on fundamentals before frameworks - Focus on fundamentals before frameworks
### Repository Maintenance ### Repository Maintenance
- Active community of learners and contributors - Active learner and contributor community
- Regular update to dependencies and content - Regular updates to content and dependencies
- Maintainers dey monitor issues and discussions - Maintainers dey monitor issues and discussions
- Translation updates dey automatic with GitHub Actions - Translation updates automated via GitHub Actions
### Related Resources ### Related Resources
- [Microsoft Learn modules](https://docs.microsoft.com/learn/) - [Microsoft Learn modules](https://docs.microsoft.com/learn/)
- [Student Hub resources](https://docs.microsoft.com/learn/student-hub/) - [Student Hub resources](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) recommended for learners - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) dey recommended for learners
- Other courses: Generative AI, Data Science, ML, IoT curricula dey available - Other courses: Generative AI, Data Science, ML, IoT curricula dey available
### Working with Specific Projects ### Working with Specific Projects
For detailed instructions about individual projects, check the README files inside: For detailed instructions on individual projects, check README files for:
- `quiz-app/README.md` - Vue 3 quiz application - `quiz-app/README.md` - Vue 3 quiz application
- `7-bank-project/README.md` - Banking app with authentication - `7-bank-project/README.md` - Banking app with authentication
- `5-browser-extension/README.md` - Browser extension development - `5-browser-extension/README.md` - Browser extension development
@ -394,15 +394,15 @@ For detailed instructions about individual projects, check the README files insi
### Monorepo Structure ### Monorepo Structure
Even though dis no be traditional monorepo, dis repository get plenty independent projects: Even though dis no be traditional monorepo, dis repository get many independent projects:
- Every lesson dey self-contained - Every lesson dey self-contained
- Projects no dey share dependencies - Projects no dey share dependencies
- You fit work on each project separately without disturbing others - You fit work on individual projects without affect others
- Clone whole repo if you wan complete curriculum experience - Clone whole repo for full curriculum experience
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Disclaimer**: **Disclaimer**:
Dis document na wetin AI translation service [Co-op Translator](https://github.com/Azure/co-op-translator) translate. Even though we dey try make am correct, make you sabi say automated translations fit get some mistakes or no too correct. The original document wey e dey for inside im own language na him be the correct source. If na important info, make person wey sabi translate am for human hand do am. We no go carry any yawa wey fit happen because of how this translation take be. Dis dokument don translate wit AI translation service [Co-op Translator](https://github.com/Azure/co-op-translator). Even tho we dey try make am correct, abeg sabi say automated translations fit get errors or mistakes. Di original dokument for im own language na di correct source. For important information, better human translation na di best. We no get fault if any misunderstanding or wrong understanding happen because of dis translation.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -493,7 +493,7 @@
}, },
"AGENTS.md": { "AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34", "original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-04-06T18:26:31+00:00", "translation_date": "2026-04-20T16:04:03+00:00",
"source_file": "AGENTS.md", "source_file": "AGENTS.md",
"language_code": "ta" "language_code": "ta"
}, },

@ -2,27 +2,27 @@
## Project Overview ## Project Overview
இது ஆரம்பநிலை பயனாளர்களுக்கு வலை மேம்பாட்டின் அடிப்படைகளை கற்பிக்கும் கல்வி பாடத்திட்ட அட்டவணை சேமிப்பகம் ஆகும். இந்த பாடத்திட்டம் Microsoft Cloud Advocates உருவாக்கிய முழுமையான 12 வார பாடநெறியாகும், இதில் JavaScript, CSS மற்றும் HTML உடன் 24 செய்முறை பாடங்கள் அடங்கும். இது ஆரம்பத்துக்கு வலை மேம்பாட்டுக்கான அடிப்படைகளை கற்பிப்பதற்கான கல்வி பாடத்திட்டக் கோப்பகம். இந்த பாடத்திட்டம் மைக்ரோசாஃப்ட் கிளவுட் வழிகாட்டிகள் உருவாக்கிய 12 வார முழுமையான பாடநெறி ஆகும், இதில் ஜாவாஸ்கிரிப்ட், CSS மற்றும் HTML ஆகியவை ஆன 24 பயிற்சி பாடங்கள் உள்ளன.
### Key Components ### Key Components
- **கல்வி உள்ளடக்கம்**: 24 கட்டமைக்கப்பட்ட பாடங்கள், திட்ட அடிப்படையிலான தொகுதிகளில் ஒழுங்குபடுத்தப்பட்டவை - **கல்வி உள்ளடக்கம்**: திட்ட அடிப்படையான தொகுதிகளாக அமைக்கப்பட்ட 24 கட்டமைக்கப்பட்ட பாடங்கள்
- **செய்முறை திட்டங்கள்**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor மற்றும் AI உரையாடல் துணை - **பயிற்சி திட்டங்கள்**: டெர்ரேரியம், தைப் விளையாட்டு, உலாவி நீட்டிப்பு, விண்வெளி விளையாட்டு, வங்கி செயலி, குறியீடு தொகுப்பான், மற்றும் AI அரட்டை உதவியாளர்
- **ணைய கேள்வித்தாள்**: 48 கேள்வித்தாள்கள், ஒவ்வொன்றிலும் 3 கேள்விகள் (முந்தைய/பின்வரும் பாட평மாற்றங்கள்) - **டையூறு தேர்வுகள்**: 3 கேள்விகளுடன் 48 தேர்வுகள் (பாட முன்னும்/பின்னும் மதிப்பீடுகள்)
- **ல்வேறு மொழி ஆதரவு**: GitHub Actions மூலம் 50+ மொழிகளுக்கு தானாக மொழிபெயர்ப்பு - **ன்மொழி ஆதரவு**: GitHub Actions மூலம் 50+ மொழிகளுக்கு தானாக மொழிபெயர்ப்பு
- **தொழில்நுட்பங்கள்**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI திட்டங்களுக்கு) - **தொழில்நுட்பங்கள்**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI திட்டங்களுக்கு)
### Architecture ### Architecture
- பாடத்திட்ட அடிப்படையிலான கல்வி சேமிப்பகம் - பாடம் அடிப்படையிலான அமைப்புடன் கல்வி கோப்பகம்
- ஒவ்வொரு பாடத்திட்ட கோப்புறைகளிலும் README, குறியீடு எடுத்துக்காட்டுகள் மற்றும் தீர்வுகள் - ஒவ்வொரு பாடலுக்கு README, குறியீடு எடுத்துக்காட்டுகள் மற்றும் தீர்வுகள் உள்ளன
- தனித்தனியான திட்டங்கள் தனி அடைவு கோப்புறைகளில் (quiz-app, வெவ்வேறு பாடத் திட்டங்கள்) - தனித்தனி திட்டங்கள் தனி அடைவுகளில் (quiz-app, பல்வேறு பாட திட்டங்கள்)
- GitHub Actions பயன்படுத்தி மொழிபெயர்ப்பு முறை (co-op-translator) - GitHub Actions (co-op-translator) பயன்படுத்தி மொழிபெயர்ப்பு அமைப்பு
- Docsify மூலம் ஆவணங்கள் வழங்கப்பட்டு PDF வடிவில் கிடைக்கும் - Docsify மூலம் ஆவணங்கள் வழங்கப்படுகிறது மற்றும் PDF ஆகவும் கிடைக்கிறது
## Setup Commands ## Setup Commands
இந்த சேமிப்பகம் முதன்மையாக 교육 உள்ளடக்கம் பயன்படுத்துவதற்காக உள்ளது. குறிப்பிட்ட திட்டங்களுடன் பணியாற்ற: இந்தக் கோப்பகம் முதன்மையாக கல்வி உள்ளடக்கம் பெறப்படுகிறது. குறிப்பிட்ட திட்டங்களுடன் வேலை செய்ய:
### Main Repository Setup ### Main Repository Setup
@ -36,9 +36,9 @@ cd Web-Dev-For-Beginners
```bash ```bash
cd quiz-app cd quiz-app
npm install npm install
npm run dev # மேம்பாட்டு சர்வரை தொடங்கு npm run dev # மேம்பாட்டு சேவையகத்தை துவக்கவும்
npm run build # உற்பத்திக்கான கட்டமைப்பு npm run build # உற்பத்திக்காக கட்டமைக்கவும்
npm run lint # ESLint ஐ இயக்கு npm run lint # ESLint ஐ இயக்கம்
``` ```
### Bank Project API (Node.js + Express) ### Bank Project API (Node.js + Express)
@ -46,8 +46,8 @@ npm run lint # ESLint ஐ இயக்கு
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm install npm install
npm start # API சர்வர் துவக்கம் npm start # API சேவையகம் துவங்கு
npm run lint # ESLint இயக்கவும் npm run lint # ESLint இயக்கவும்
npm run format # Prettier உடன் வடிவமைக்கவும் npm run format # Prettier உடன் வடிவமைக்கவும்
``` ```
@ -56,7 +56,7 @@ npm run format # Prettier உடன் வடிவமைக்கவும
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
npm install npm install
# உலாவி-சார்ந்த விரிவாக்க ஏற்றும் வழிமுறைகளை பின்பற்றவும் # உலாவிச் சிறப்பான நீட்டிப்பு ஏற்றும் வழிமுறைகளைக் பின்பற்றவும்
``` ```
### Space Game Projects ### Space Game Projects
@ -64,7 +64,7 @@ npm install
```bash ```bash
cd 6-space-game/solution cd 6-space-game/solution
npm install npm install
# கணினி உலாவியில் index.html கோப்பை திறக்கவும் அல்லது Live Server ஐ பயன்படுத்தவும் # index.html ஐ உலாவியில் திறக்கவும் அல்லது Live Server ஐ பயன்படுத்தவும்
``` ```
### Chat Project (Python Backend) ### Chat Project (Python Backend)
@ -72,7 +72,7 @@ npm install
```bash ```bash
cd 9-chat-project/solution/backend/python cd 9-chat-project/solution/backend/python
pip install openai pip install openai
# GITHUB_TOKEN சூழல் மாறியை அமைக்கவும் # GITHUB_TOKEN சுற்றுச்சூழல் மாறியினை அமைக்கவும்
python api.py python api.py
``` ```
@ -80,29 +80,29 @@ python api.py
### For Content Contributors ### For Content Contributors
1. **உங்கள் GitHub கணக்கில் சேமிப்பகத்தை Fork செய்யவும்** 1. **கோப்பகத்தை** உங்கள் GitHub கணக்குக்கு fork செய்யவும்
2. **உங்கள் Fork ஐ உள்ளூரில் Clone செய்யவும்** 2. **உங்கள் fork**-ஐ உள்ளூர் கணினியில் clone செய்யவும்
3. **உங்களுக்கு தேவையான மாற்றங்களுக்கான புதிய branch உருவாக்கவும்** 3. **புதிய கிளை** உருவாக்கி மாற்றங்களுக்காக வேலை செய்யவும்
4. பாடக் கட்டுரைகள் அல்லது குறியீடு எடுத்துக்காட்டுகளில் மாற்றங்கள் செய்யவும் 4. பாட உள்ளடக்கம் அல்லது குறியீடு எடுத்துக்காட்டுகளில் மாற்றங்கள் செய்யவும்
5. தொடர்புடைய திட்டக் கோப்புறைகளில் எந்த குறியீடு மாற்றங்களும் சோதிக்கவும் 5. சம்பந்தப்பட்ட திட்ட அடைவுகளில் குறியீடு பரிசோதனை செய்யவும்
6. பங்கீடு வழிகாட்டுதல்களை பின்பற்றி Pull Requests சமர்ப்பிக்கவும் 6. பங்களிப்பு வழிகாட்டுதல்களை பின்பற்றி pull request-ஐ சமர்ப்பிக்கவும்
### For Learners ### For Learners
1. சேமிப்பகத்தை Fork செய்யவோ அல்லது Clone செய்யவோ செய்யவும் 1. கோப்பகத்தை fork அல்லது clone செய்யவும்
2. பாடக் கோப்புறைகளில் தொடர் முறையில் செல்க 2. பாட அடைவுகளில் தொடர்ச்சியாக செல்லவும்
3. ஒவ்வொரு பாடத்திற்கும் README கோப்புகளை படிக்கவும 3. ஒவ்வொரு பாடத்திற்குமான README கோப்புகளை படியுங்கள
4. முன் பாடக் கேள்வித்தாள்களை https://ff-quizzes.netlify.app/web/ இல் முடிக்கவும் 4. பாட முன்னுரை தேர்வுகளை https://ff-quizzes.netlify.app/web/ என்ற இடத்தில் முடிக்கவும்
5. பாடக் கோப்புறைகளில் குறியீடு எடுத்துக்காட்டுகளில் பணியாற்றவும் 5. பாட அடைவுகளில் உள்ள குறியீடு எடுத்துக்காட்டுகளை செயல்படுத்தவும்
6. பயிற்சிகளையும் சவால்களையும் முடிக்கவும் 6. பணிகள் மற்றும் சவால்களை முடிக்கவும்
7. பாடத்திற்குப்பிறகு கேள்வித்தாள்களையும் எடுத்துக் கொள்ளவும் 7. பாட பின் தேர்வுகளை எடுக்கவும்
### Live Development ### Live Development
- **ஆவணங்கள்**: ரூட் கோப்புறையில் `docsify serve` இயக்கவும் (போர்ட் 3000) - **ஆவணங்கள்**: ரூட் ஃபோல்டரில் `docsify serve` இயக்கவும் (போர்ட் 3000)
- **Quiz App**: `quiz-app` கோப்புறையில் `npm run dev` இயக்கவும் - **Quiz App**: quiz-app அடைவில் `npm run dev` இயக்கவும்
- **திட்டங்கள்**: HTML திட்டங்களுக்கு VS Code Live Server விரிவாக்கத்தை பயன்படுத்தவும் - **திட்டங்கள்**: HTML திட்டங்களுக்கு VS Code Live Server நீட்டிப்பு பயன்படுத்தவும்
- **API திட்டங்கள்**: தொடர்புடைய API கோப்புறைகளில் `npm start` இயக்கவும் - **API திட்டங்கள்**: சம்பந்தப்பட்ட API அடைவுகளில் `npm start` இயக்கவும்
## Testing Instructions ## Testing Instructions
@ -110,173 +110,173 @@ python api.py
```bash ```bash
cd quiz-app cd quiz-app
npm run lint # குறியீடு பாணி பிரச்சனைகள் உள்ளதா என பரிசோதிக்கவும் npm run lint # குறியீட்டு வடிவமைப்பு பிரச்சனைகளை சரிபார்க்கவும்
npm run build # கட்டுமானம் வெற்றிபெறுவதை உறுதி செய்க npm run build # கட்டமைப்பு வெற்றி பெறுகிறதா என்று உறுதி செய்யவும்
``` ```
### Bank API Testing ### Bank API Testing
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
npm run lint # குறியீட்டு பாணி சிக்கல்களை சரிபார்க்கவும npm run lint # குறியீட்டு ஒழுங்குக்கான பிரச்சனைகளை சரிபார
node server.js # பிழைகள் இல்லாமல் சேவையகம் துவங்குவதை உறுதிப்படுத்தவும் node server.js # சேவையகம் பிழைகளின்றி துவங்குகிறது என்பதை உறுதிப்படுத்துக
``` ```
### General Testing Approach ### General Testing Approach
- இது முழுமையான தானாக சோதனைகள் இல்லாத கல்வி சேமிப்பகமாகும் - இது முழுமையான தானியங்கி பரிசோதனைகள் இல்லாத கல்வி கோப்பகம்
- கைமுறை சோதனைகள் கவனம் செலுத்தும்: - கைமுறை பரிசோதனையில் கவனம்:
- குறியீடு எடுத்துக்காட்டுகள் பிழை 없이 இயங்குகின்றன - குறியீடு எடுத்துக்காட்டுகள் பிழையின்றி இயங்குவது
- ஆவணங்களில் உள்ள இணைப்புகள் சரியாக செயல்படுகின்றன - ஆவணங்களில் உள்ள இணைப்புகள் சரியாக வேலை செய்வது
- திட்ட கட்டமைப்பு வெற்றிகரமாக முடிவடைகிறது - திட்ட கட்டமைப்புகள் வெற்றிகரமாக முடிவடைது
- எடுத்துக்காட்டுகள் சிறந்த நடைமுறைகளை பின்பற்றுகின்றன - எடுத்துக்காட்டுகள் சிறந்த நடைமுறைகளை பின்பற்றுவது
### Pre-submission Checks ### Pre-submission Checks
- பாகெஜ்.json உள்ள கோப்புறைகளில் `npm run lint` ஓடு - package.json உள்ள அடைவுகளில் `npm run lint` இயக்கவும்
- மார்க்டவுன் இணைப்புகள் செல்லுபடியாக உள்ளதா என சரிபார்க்கவும் - மார்க்டவுன் இணைப்புகள் செல்லுபடியாக தெரிந்து கொள்ளவும்
- குறியீடு எடுத்துக்காட்டுகளை உலாவியும் Node.js இலும் சோதிக்கவும் - குறியீடு எடுத்துக்காட்டுகளை உலாவி அல்லது Node.js-ல் சோதிக்கவும்
- மொழிபெயர்ப்பு வடிவமைப்பு சரியானதை உறுதி செய்யவும் - மொழிபெயர்ப்புகள் சரியான கட்டமைப்பை பின்பற்றுவதை உறுதி செய்யவும்
## Code Style Guidelines ## Code Style Guidelines
### JavaScript ### JavaScript
- ES6+ நவீன இலக்கணம் பயன்படுத்தவும் - நவீன ES6+ син்டக்ஸை பயன்படுத்தவும்
- திட்டங்களில் கொடுக்கப்பட்ட படி ESLint கட்டமைப்புகளை பின்பற்றவும் - திட்டங்களில் வழங்கப்பட்ட சாதாரண ESLint அமைப்புகளை பின்பற்றவும்
- கல்வி தெளிவுக்கு பொருத்தமான மாறிலிகள் மற்றும் செயல்பாட்டு பெயர்கள பயன்படுத்தவும் - கல்விக்கான தெளிவான மாறிகள் மற்றும் செயல்பாட்டு பெயர்கள பயன்படுத்தவும்
- கற்றுக்கொள்ளும் பயனாளர்களுக்கு கருத்துக்களைச் சேர்க்கவும் - கற்றுக்கொள்ளும் மாணவர்களுக்கு கருத்துரைகள் சேர்க்கவும்
- Prettier பயன்படுத்தப்படும்படி வடிவமைக்கவும் - Prettier மூலம் வடிவமைப்பு செய்யவும் (அமைக்கப்பட்டிருந்தால்)
### HTML/CSS ### HTML/CSS
- அர்த்தமுள்ள HTML5 கூறுகள் - பொருத்தமான HTML5 கூறுகள்
- பதிலளிக்கும் வடிவமைப்பு 원칙 - பதிலளிக்கும் வடிவமைப்பு 원칙ங்கள்
- தெளிவான வகுப்பு பெயரிடுதல் - தெளிவான வகுப்பு பெயரிடுதல்
- CSS தொழில்நுட்பங்களை விளக்கும் கருத்துக்கள் - CSS தொழில்நுட்பங்களை விளக்கும் கருத்துரைகள்
### Python ### Python
- PEP 8 முறைநெறிகள் - PEP 8 நடைமுறைகள்
- தெளிவான கல்வி குறியீடு எடுத்துக்காட்டுகள் - தெளிவான, கல்வி குறியீடு எடுத்துக்காட்டுகள்
- கற்றல் உதவிக் குறிப்பு வகைப் பகுக்கைகள் - கற்றல் உதவியாக கண்டிப்புகளுடன்
### Markdown Documentation ### Markdown Documentation
- தெளிவான தலைப்பு அமைப்ப - தெளிவான தலைப்பு ஒழுங்க
- மொழி குறிப்புடன் குறியீடு தொகுதிகள் - மொழி குறிப்பிடப்பட்ட குறியீடு தொகுதிகள்
- கூடுதல் வளங்களுக்கான இணைப்புகள் - கூடுதல் வளங்களுக்கான இணைப்புகள்
- `images/` கோப்புறைகளில் ஸ்கிரீன்ஷாட்கள் மற்றும் படங்கள - படங்கள் மற்றும் ஸ்கிரீன்ஷாட்கள் `images/` அடைவுகளில
- அணுகல் உதவிக்காக படங்களுக்கு Alt உரை - படங்களுக்கு அணுகலை உறுதி செய்ய alt உரை
### File Organization ### File Organization
- பாடங்கள் தொடர்ச்சியான எண்ணிக்கைகளில் (1-getting-started-lessons, 2-js-basics போன்றவை) - பாடங்கள் வரிசைப்படுத்தப்பட்ட இலக்குகளுடன் (1-getting-started-lessons, 2-js-basics, மற்றும் இலகு)
- ஒவ்வொரு திட்டத்திற்கும் `solution/` மற்றும் பெரும்பாலும் `start/` அல்லது `your-work/` அடைவுகள் - ஒவ்வொரு திட்டத்திும் `solution/` மற்றும் பெரும்பாலும் `start/` அல்லது `your-work/` அடைவுகள்
- பாடத்திட்ட குறிப்பான `images/` கோப்புறைகளில் படங்கள் - படங்கள் பாடத்திற்கு தொடர்பான `images/` அடைவுகளில் சேமிக்கப்பட்டவை
- மொழிபெயர்ப்புகள் `translations/{language-code}/` அமைப்பில் - மொழிபெயர்ப்புகள் `translations/{language-code}/` கட்டமைப்பில்
## Build and Deployment ## Build and Deployment
### Quiz App Deployment (Azure Static Web Apps) ### Quiz App Deployment (Azure Static Web Apps)
quiz-app Azure Static Web Apps க்கான கட்டமைப்புடன் உள்ளது: quiz-app Azure Static Web Apps அமைப்புடன் கூடியது:
```bash ```bash
cd quiz-app cd quiz-app
npm run build # dist/ கோப்பகத்தை உருவாக்குகிறது npm run build # dist/ கோப்புறை உருவாக்குகிறது
# முக்கிய கிளைக்கு தள்ளும்போது GitHub Actions பணியினூடாக орналுத்துகிறது # முக்கிய கிளையில் தள்ளும்போது GitHub Actions பணிச்சுழற்சியினூடாக வெளியிடுகிறது
``` ```
Azure Static Web Apps அமைப்பு: Azure Static Web Apps அமைப்பு:
- **App இடம்**: `/quiz-app` - **ஆபிள் இருப்பிடம்**: `/quiz-app`
- **வெளியீட்டு இடம்**: `dist` - **வெளியீடு இருப்பிடம்**: `dist`
- **பணி ஓட்டம்**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` - **வேலைநடத்தை**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Documentation PDF Generation ### Documentation PDF Generation
```bash ```bash
npm install # docsify-to-pdf ஐ நிறுவவும் npm install # docsify-to-pdf ஐ நிறுவவும்
npm run convert # டாக்ஸ்-இல் இருந்து PDF உருவாக்கவும் npm run convert # docs இலிருந்து PDF உருவாக்கவும்
``` ```
### Docsify Documentation ### Docsify Documentation
```bash ```bash
npm install -g docsify-cli # Docsify-ஐ உலகளாவிய இடத்தில் நிறுவுக npm install -g docsify-cli # Docsify-ஐ உலகளாவியமாக நிறுவவும்
docsify serve # localhost:3000 இல் சேவை செய்க docsify serve # localhost:3000-ல் சேவை செய்யவும்
``` ```
### Project-specific Builds ### Project-specific Builds
ஒவ்வொரு திட்டக் கோப்புறைக்கும் தனிப்பட்ட கட்டுமான செயல்முறை இருக்கலாம்: ஒவ்வொரு திட்ட அடைவுக்கும் தனித்துவமான கட்டுமான செயல்முறை இருக்கலாம்:
- Vue திட்டங்கள்: `npm run build` உற்பத்தி தொகுப்புகளை உருவாக்கும் - Vue திட்டங்கள்: `npm run build` மூலம் தயாரிப்பு தொகுப்புகள் உருவாக்கப்படும்
- நிலைபேறு திட்டங்கள்: எந்த கட்டுமான படியும் தேவையில்லை, நேரடியாக கோப்புகளை சேவை செய்கின்றது - நிலையான திட்டங்கள்: கட்டுமான படிகள் இல்லாமல் நேரடியாக கோப்புகள் வழங்கப்படுvம்
## Pull Request Guidelines ## Pull Request Guidelines
### Title Format ### Title Format
மாற்றம் செய்யப்பட்ட பகுதியை தெளிவான, விளக்கமான தலைப்புகளில் குறிப்பிடவும்: மாற்றத்தின் பகுதியைப் பற்சொல்லும் தெளிவான தலைப்புகளைப் பயன்படுத்தவும்:
- `[Quiz-app] பாடம் X க்கான புதிய கேள்வித்தாள் சேர்க்கவும்` - `[Quiz-app] புதுப் பாடத்திற்கான புதிய தேர்வு சேர்க்கப்பட்டது`
- `[Lesson-3] terrarium திட்டம் பிழை திருத்தப்பட்டது` - `[Lesson-3] டெர்ரேரியம் திட்டத்தில் எழுத்து பிழை திருத்தப்பட்டது`
- `[Translation] பாடம் 5 இற்கான ஸ்பானிஷ் மொழிபெயர்ப்பைச் சேர்க்கவும்` - `[Translation] பாடம் 5 இல் ஸ்பானிஷ் மொழிபெயர்ப்பு இணைக்கப்பட்டது`
- `[Docs] அமைப்பு அறிவுறுத்தல்களை புதுப்பிக்கவும்` - `[Docs] அமைப்பு வழிகாட்டிகள் புதுப்பிக்கப்பட்டன`
### Required Checks ### Required Checks
PR சமர்ப்பிக்குமுன்பு: PR சமர்ப்பிக்கும் முன்:
1. **குறியீடு தரம்**: 1. **குறியீடு தரம்**:
- பாதிக்கப்பட்ட திட்டக் கோப்புறைகளில் `npm run lint` ஓடு - பாதிக்கப்பட்ட திட்ட அடைவுகளில் `npm run lint` இயக்கவும்
- அனைத்து பிழை மற்றும் எச்சரிக்கைகளை சரி செய்யவும் - அனைத்து பிழைகள் மற்றும் எச்சரிக்கைகள் சரி செய்யப்பட வேண்டும்
2. **கட்டுமான சரிபார்ப்பு**: 2. **கட்டுமான உறுதி**:
- பொருந்துமானால் `npm run build` ஓடு - பொருத்தமாக இருந்தால் `npm run build` இயக்கவும்
- கட்டுமான பிழைகள் இல்லாது இருப்பதை உறுதி செய்க - கட்டுமான பிழைகள் இல்லாது இருக்க வேண்டும்
3. **இணைப்பு சரிபார்ப்பு**: 3. **இணைப்பு சரிபார்ப்பு**:
- அனைத்து மார்க்டவுன் இணைப்புகளையும் சோதிக்கவும் - எல்லா மார்க்டவுன் இணைப்புகளும் சோதிக்கப்பட ேண்டும்
- படங்கள் சரியாக உள்ளதா என உறுதி செய்யவும் - பட இணைப்புகளும் சரியாக வேலை செய்ய வேண்டும்
4. **உள்ளடக்கம் சோதனை**: 4. **உள்ளடக்கம் மதிப்பாய்வு**:
- எழுத்துப் பிழைகள் மற்றும் இலக்கண பிழைகள் இல்லாததை உறுதி செய்யவும் - எழுத்துப்பிழைகள் மற்றும் இலக்கணம் சரிபார்க்கவும்
- குறியீடு எடுத்துக்காட்டுகள் சரியாகவும் கல்விக்காக பொருத்தமாகவும் இருக்க வேண்டும் - குறியீடு எடுத்துக்காட்டுகள் சரியானவை மற்றும் கல்விக்கும் உகந்ததாக இருக்க வேண்டும்
- மொழிபெயர்ப்புகள் கோட்பாடு மாற்றம் இல்லாமல் இருக்க வேண்டும் - மொழிபெயர்ப்புகள் அசல் அர்த்தத்தை பராமரிக்க வேண்டும்
### Contribution Requirements ### Contribution Requirements
- Microsoft CLA க்கு உடன்படுதல் (முதல் PR இல் தானாக பரிசோதனை) - Microsoft CLA-க்கு சம்மதிக்க வேண்டும் (முதல் PR-க்கு தானாகச் சோதனை)
- [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) பின்பற்றுதல - [Microsoft Open Source நடைமுறை சட்டத்தை](https://opensource.microsoft.com/codeofconduct/) பின்பற்றவும
- விரிவான வழிகாட்டல்களுக்கு [CONTRIBUTING.md](./CONTRIBUTING.md) பார்க்கவும் - விரிவான வழிகாட்டிகளுக்கு [CONTRIBUTING.md](./CONTRIBUTING.md) பார்க்கவும்
- தேவையானால் PR விளக்கத்தில் விவகார எண்களை குறிப்பிடவும் - தொடர்புடைய பிரச்சினை எண்களை PR விளக்கத்தில் குறிப்பிடவும் (அதவாக இருந்தால்)
### Review Process ### Review Process
- PR களை பராமரிப்பவர்களும் சமூகமும் மதிப்பாய்வு செய்கின்றனர் - PR-கள் பராமரிப்பவர்களும் சமூகத்தினராலும் ஆய்வு செய்யப்படுகின்றன
- கல்வி தெளிவுக்கு முன்னுரிமை வழங்கப்படுகிறது - கல்விக்கான தெளிவை முன்னுரிமை வைக்கிறது
- குறியீடு எடுத்துக்காட்டுகள் நடந்துறை சிறந்த நடைமுறைகளுக்கு ஏற்ப இருக்க வேண்டும் - குறியீடு எடுத்துக்காட்டுகள் இதய நடைமுறைகளை பின்பற்ற வேண்டும்
- மொழிபெயர்ப்புகள் துல்லியமும் பண்பாட்டு பொருத்தமும் ஏற்கப்பட்டுள்ளது - மொழிபெயர்ப்புகள் துல்லியமும் பண்பாட்டு பொருத்தமும் கொண்டதாக இருக்க வேண்டும்
## Translation System ## Translation System
### Automated Translation ### Automated Translation
- co-op-translator பணிமுறை கொண்ட GitHub Actions பயன்படுத்தப்படுகிறது - GitHub Actions உடன் co-op-translator வேலை ஓட்டத்தை உபயோகிக்கிறது
- 50+ மொழிகளுக்கு தானாக மொழிபெயர்ப்பு செய்கிறது - 50+ மொழிகளுக்கு தானாக மொழிபெயர்க்கின்றது
- மூல கோப்புகள் பிரதான கோப்புறைகளில் - மூல கோப்புகள் முக்கிய அடைவுகளில் உள்ளன
- மொழிபெயர்க்கப்பட்ட கோப்புகள் `translations/{language-code}/` கோப்புறைகளில் - மொழிபெயர்க்கப்பட்ட கோப்புகள் `translations/{language-code}/` அடைவுகளில் இருக்கும்
### Adding Manual Translation Improvements ### Adding Manual Translation Improvements
1. `translations/{language-code}/` இல் கோப்பை கண்டறியவும் 1. `translations/{language-code}/` இல் கோப்புகளை கண்டறியவும்
2. கட்டமைப்பை பாதுகாத்து மேம்படுத்தல்கள் செய்யவும் 2. கட்டமைப்பை காப்பாற்றி மேம்பாடுகள் சேர்க்கவும்
3. குறியீடு எடுத்துக்காட்டுகள் செயல்படும் நிலையை உறுதி செய்யவும் 3. குறியீடு எடுத்துக்காட்டுகள் செயல் திறன் இழக்காமல் இருக்க வேண்டும்
4. உள்ளூர் கேள்வித்தாள் உள்ளடக்கங்களைக் சோதிக்கவும் 4. உள்ளூர் தேர்வு உள்ளடக்கம் இருப்பின் சோதனை செய்யவும்
### Translation Metadata ### Translation Metadata
மொழிபெயர்க்கப்பட்ட கோப்புகளில் பின்வரும் மெட்டா தகவல் தலைப்பு உள்ளது: மொழிபெயர்ப்பு கோப்புகளில் metadata தலைப்பு உள்ளடக்கம்:
```markdown ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: CO_OP_TRANSLATOR_METADATA:
@ -293,116 +293,116 @@ CO_OP_TRANSLATOR_METADATA:
### Common Issues ### Common Issues
**Quiz app துவங்கவில்லை**: **தேர்வு செயலி துவங்கவில்லை**:
- Node.js பதிப்பு (v14+ பரிந்துரைக்கப்படுகிறது) சரிபார்க்கவும - Node.js பதிப்பு (v14+ பரிந்துரைக்கப்படுகிறது) சரி பார்த்தல
- `node_modules` மற்றும் `package-lock.json` ஐ நீக்கி மீண்டும் `npm install` ஒதுக்கவும - `node_modules` மற்றும் `package-lock.json` அழித்து, `npm install` மீண்டும் இயக்குதல
- போர்ட் மாறுபாடுகள் உள்ளதா என பார்க்கவும் (இயல்புநிலை: Vite போர்ட் 5173 பயன்படுத்துகிறது) - போர்ட் முரண்பாடுகள் இருக்கிறதா என்று போக்காய்வது (இயல்பானது: Vite போர்ட் 5173 பாவிக்கிறது)
**API சர்வர் துவங்கவில்லை**: **API சேவையகம் துவங்கவில்லை**:
- Node.js குறைந்தபட்ச பதிப்பு (node >=10) இருக்கிறது என உறுதி செய்யவும் - Node.js பதிப்பு குறைந்தபட்சம் (node >=10) என்பது உறுதி செய்யவும்
- போர்ட் ஏற்கனவே பயன்படுத்தப்படுகிறதா என பார்க்கவும் - போர்ட் ஏற்கனவே பயன்படுத்தப்பட்டு வருகிறதா என்று சரிபார்க்கவும்
- அனைத்து பிையதளங்கள் `npm install` மூலம் நிறுவப்பட்டுள்ளன என உறுதி செய்யவும் - தேவையான அனைத்து சார்ந்த பண்புகள் `npm install` மூலம் நிறுவப்பட்டுள்ளன என்பதை உறுதிசெய்யவும்
**Browser extension ஏற்றப்படவில்லை**: **உலாவி நீட்டிப்பு ஏற்றவில்லை**:
- manifest.json முறையாக வடிவமைக்கப்பட்டுள்ளது என சரிபார்க்கவும் - manifest.json சரியாக வடிவமைக்கப்பட்டிருக்கிறதா என்பதைக் கண்டறியவும்
- உலாவி கண்டோலை பிழைத் தகவலுக்காக பார்க்கவும் - உலாவி கன்சோலில் பிழைகள் உள்ளதா பார்க்கவும்
- உலாவி தனித்துவ நீட்டிப்பு நிறுவல் வழிகாட்டுதலை பின்பற்றவும் - உலாவி-சார்ந்த நீட்டிப்பு நிறுவல் வழிகாட்டுதல்களை பின்பற்றவும்
**Python உரையாடல் திட்ட பிழைகள்**: **Python அரட்டை திட்ட பிரச்சினைகள்**:
- OpenAI பைதான் தொகுப்பு நிறுவியுள்ளீர்களா: `pip install openai` - OpenAI பைதான் தொகுப்பு நிறுவியுள்ளீர்களா: `pip install openai`
- GITHUB_TOKEN சூழல் மாறிலி அமைக்கப்பட்டுள்ளது என்பதை உறுதி செய்யவும் - GITHUB_TOKEN சுற்றுச்சூழல் மாறி அமைக்கப்பட்டுள்ளத
- GitHub Models அணுகல் அனுமதிகளைச் சரிபார்க்கவும் - GitHub மாதிரிகள் அணுகல் அனுமதிகள் சரிபார்க்கவும்
**Docsify ஆவணங்கள் வழங்கவில்லை**: **Docsify ஆவணங்கள் வழங்கவில்லை**:
- globals ஆக docsify-cli நிறுவவும்: `npm install -g docsify-cli` - docsify-cli-வை உலகளாவியமாக நிறுவவும்: `npm install -g docsify-cli`
- சேமிப்பகத்தின் ரூட் கோப்புறையில் இருந்து இயக்கவும் - கோப்பகம் ரூட்டிலிருந்து இயக்கவும்
- `docs/_sidebar.md` உள்ளது என உறுதி செய்யவும் - `docs/_sidebar.md` உள்ளதா நன்றாக பார்க்கவும்
### Development Environment Tips ### Development Environment Tips
- HTML திட்டங்களுக்கு VS Code Live Server விரிவாக்கம் பயன்படுத்தவும் - HTML திட்டங்களுக்கு VS Code Live Server நீட்டுப்பயன்பாடு பயன்படுத்தவும்
- ஒருமையான வடிவமைப்புக்கு ESLint மற்றும் Prettier விரிவாக்கங்களை நிறுவவும் - ஒருமைத்தன்மை வடிவமைப்புக்கு ESLint மற்றும் Prettier நீட்டிப்புகள் நிறுவவும்
- JavaScript பிழைத்திருத்தத்திற்கு உலாவி DevTools பயன்படுத்தவும் - JavaScript பிழைதிருத்தத்திற்கு உலாவி DevTools பயன்படுத்தவும்
- Vue திட்டங்களுக்கு Vue DevTools உலாவி விரிவாக்கம் நிறுவவும் - Vue திட்டங்களுக்கு Vue DevTools உலாவி நீட்டிப்பை நிறுவவும்
### Performance Considerations ### Performance Considerations
- 50+ மொழிகளில் மொழிபெயர்க்கப்பட்ட கோப்புகளின் பெரும் எண்ணிக்கை முழு clone யை பெரிதாக்குகிறது - 50+ மொழிகளின் ஏராளமான மொழிபெயர்ப்பு கோப்புக்கள் இருப்பதால் முழுமையான கிளோன் பெரியது
- உள்ளடக்கம் வேலை செய்வதால் மட்டுமே நேர்மறை clone பயன்படுத்தவும்: `git clone --depth 1` - உள்ளடக்கம் மட்டுமே வேண்டுமானால், `git clone --depth 1` என்ற குறுகிய கிளோன் பயன்படுத்தவும்
- ஆங்கில உள்ளடக்கத்துடன் செயல்படும் பொழுது மொழிபெயர்ப்புகளைத் தேடல்களில் தவிர்க்கவும் - ஆங்கில உள்ளடக்கம் மீது வேலைசெய்யும் போது தேடலில் மொழிபெயர்ப்புகளை தவிர்க்கவும்
- முதல் முறையில் கட்டுமான செயல்முறைகள் மெல்லியதாக இருக்கலாம் (npm install, Vite கட்டமைபபு) - முதலாவது இயக்கத்தில் கட்டுமான செயல்முறைகள் மெதுவாக இருக்கலாம் (npm install, Vite கட்டிடம்)
## Security Considerations ## Security Considerations
### Environment Variables ### Environment Variables
- API விசைகள் எப்போதும் சேமிப்பகத்தில் commit செய்யக்கூடாது - API மேலதிக விசைகளின் GitHub கோப்பகத்தில் கட்-பிடிக்க கூடாது
- `.env` கோப்புகளை பயன்படுத்தவும் (இவை `.gitignore` இல் உள்ளன) - `.env` கோப்புகளை பயன்படுத்தவும் (`.gitignore`யில் முன்பிருந்தே சேர்க்கப்பட்டுள்ளது)
- தேவையான சூழல் மாறிலிகள் திட்ட README களில் ஆவணப்படுத்தவும் - தேவையான சுற்றுச்சூழல் மாறிகள் README-ல் குறிப்பிடப்பட வேண்டும்
### Python Projects ### Python Projects
- மெய்நிகர் சூழல்கள் பயன்படுத்து: `python -m venv venv` - மெய்நிகர் சூழலை பயன்படுத்தவும்: `python -m venv venv`
- பிையதளங்கள் புதுப்பிக்கப்பட்டவையாக வைத்திருங்கள - சார்ந்த பண்புகள் புதுப்பிக்கப்பட்ட நிலை வைத்திருக்கவும
- GitHub குறிப்பளை குறைந்த அனுமதிகளுடன் வைத்திருங்கள் - GitHub டோக்கன்களுக்கு குறைந்தபட்ச அனுமதிகள் கொடுக்கப்பட வேண்டும்
### GitHub Models Access ### GitHub Models Access
- GitHub Models க்கான தனிப்பட்ட அணுகல் குறிகள் (PAT) தேவை - GitHub மாதிரிகளுக்கு தனிப்பட்ட அணுகல் டோக்கன்கள் (PAT) தேவையாம்
- குறிகள் சூழல் மாறிலிகளில் பயன்படுத்தப்பட வேண்டும் - டோக்கன்கள் சுற்றுச்சூழல் மாறிகளாக சேமிக்கப்பட வேண்டும்
- குறிகள் அல்லது கடவுச்சொற்கள் commit செய்யப்படக்கூடாது - ஒருபோதும் டோக்கன்கள் அல்லது கடவுச்சொற்களை கட்-பிடிக்க கூடாது
## Additional Notes ## Additional Notes
### Target Audience ### Target Audience
- வலை மேம்பாட்டில் முழுமை ஆரம்பவர்கள் - வலை மேம்பாட்டுக்கு முழுமையான புதியவர்கள்
- மாணவர்கள் மற்றும் சுயபடிப்பாளர்கள் - மாணவர்கள் மற்றும் சுய கற்றல் பயில்பவர்கள்
- வகுப்பறைகளில் பாடத்திட்டத்தைப் பயன்படுத்தும் ஆசிரியர்கள் - வகுப்பறைில் பாடத்திட்டத்தை பயன்படுத்தும் ஆசிரியர்கள்
- உள்ளடக்கம் அணுகல் மற்றும் படிப்படியாக திறன்களை உருவாக்க வடிவமைக்கப்பட்டுள்ளது - உள்ளடக்கம் அணுகும் திறன் மற்றும் படிப்படியாக திறன் வளர்ப்புக்கு வடிவமைக்கப்பட்டுள்ளது
### Educational Philosophy ### Educational Philosophy
- திட்ட அடிப்படையிலான கற்றல் முறைகள் - திட்ட அடிப்படையிலான கற்றல் முறைகள்
- அடிக்கடி அறிவுத் திருத்தங்கள் (கேள்வித்தாள்கள்) - அடிக்கடி அறிவு பரிசோதனைகள் (தேர்வுகள்)
- கைமுறை குறியீடு பயிற்சிகள் - கைபிடியக் கற்றல் பயிற்சிகள்
- உண்மையான பயன்பாட்டு எடுத்துக்காட்டுகள் - நடைமுறை பயன்பாட்டு எடுத்துக்காட்டுகள்
- கட்டமைப்புகள் முன் அடிப்படைகளில் கவனம் செலுத்துதல் - கட்டமைப்புகளுககு முன் அடிப்படைகளில் கவனம்
### Repository Maintenance ### Repository Maintenance
- செயல்பாட்டில் உள்ள கற்றல் மற்றும் பங்களிப்பாளர் சமூகம் - செயல்பாட்டுள்ள கற்றல்விதிச் சமூகமும் பங்களிப்பாளர்களும்
- பிையதளங்கள் மற்றும் உள்ளடக்கங்களில் தவணம் மற்றும் புதுப்பிப்புகள் - சார்ந்த பண்புகள் மற்றும் உள்ளடக்கங்கள் நிலையான புதுப்பிப்புகள்
- குறியீடு மற்றும் விவாதங்கள் பராமரிப்பாளர்களால் கண்காணிக்கப்படுகின்றன - பிரச்சினைகள் மற்றும் விவாதங்களை பராமரிப்போர் கவனிக்கின்றனர்
- மொழிபெயர்ப்பு புதுப்பிப்புகள் GitHub Actions மூலம் தானாக நடைபெறுகின்றன - மொழிபெயர்ப்பு புதுப்பிப்புகள் GitHub Actions மூலம் தானியாக நடக்கும்
### Related Resources ### Related Resources
- [Microsoft Learn செயல்முறை](https://docs.microsoft.com/learn/) - [Microsoft Learn modules](https://docs.microsoft.com/learn/)
- [மாணவர் ஹப் வளங்கள்](https://docs.microsoft.com/learn/student-hub/) - [Student Hub resources](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) கற்றலுக்கான பரிந்துரை - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) மாணவர்களுக்கு பரிந்துரைக்கப்படுகிறது
- கூடுதல் பாடநெறிகள்: Generative AI, தரவு அறிவியல், இயந்திர கற்றல், IoT கற்கைத் தொகுப்புகள் - கூடுதல் பாடநெறிகள்: உருவாக்கும் AI, தரவு அறிவியல், இயற்பியல் கற்றல், IoT பாடத்திட்டங்கள் உண்டு
### Working with Specific Projects ### Working with Specific Projects
தனித்தனியாய் திட்டங்களைச் செயல்படுத்த Readme கோப்புக்கள் பார்க்கவும்: தனித்தனி திட்டங்களுக்கான விரிவான வழிகாட்டிகளுக்கு README கோப்புகளுக்கு காணவும்:
- `quiz-app/README.md` - Vue 3 கேள்வித்தாள் செயலி - `quiz-app/README.md` - Vue 3 தேர்வு செயலி
- `7-bank-project/README.md` - அங்கீகாரம் உடன் வங்கி செயலி - `7-bank-project/README.md` - அங்கீகாரம் கொண்ட வங்கி செயலி
- `5-browser-extension/README.md` - உலாவி நீட்டிப்பு மேம்பாடு - `5-browser-extension/README.md` - உலாவி நீட்டிப்பு மேம்பாடு
- `6-space-game/README.md` - கேன்வாஸ் அடிப்படையிலான கேம் மேம்பாடு - `6-space-game/README.md` - கேன்வாஸ் அடிப்படையிலான விளையாட்டு மேம்பாடு
- `9-chat-project/README.md` - AI உரையாடல் உதவியாளர் திட்டம் - `9-chat-project/README.md` - AI அரட்டை உதவியாளர் திட்டம்
### Monorepo Structure ### Monorepo Structure
சாதாரண மொனோரோப்பாக இல்லாவிட்டாலும், இந்த சேமிப்பகத்தில் பல தனித்தந் திட்டங்கள் உள்ளன: இனியொரு பிரமாண மொணோ ரெப்போ அல்லினும், இந்தக் கோப்பகம் பல தனித்தனி திட்டங்களை கொண்டுள்ளது:
- ஒவ்வொரு பாடமும் தனித்தனியாக உள்ளது - ஒவ்வொரு பாடமும் தனித்தனியாது
- திட்டங்கள் பிணையதளங்களை பகிர்ந்து கொள்வதில்லை - திட்டங்களுக்கிடையே சார்ந்த பண்புகள் பகிர்ந்துகொள்ளப்படாது
- ஒரே நேரத்தில் பலத்த திட்டங்களில் வேலை செய்யாமல் தனித்தனியே பணிசெய்யலாம் - மற்றவர்களை பாதிக்காமல் தனித்தனி திட்டங்களில் வேலை செய்யலாம்
- முழு பாடத்திட்ட அனுபவத்திற்கு முழு சேமிப்பகத்தை கிளோன் செய்யவும் - முழு பாடத்திட்ட அனுபவத்துக்காக முழு கோப்பகத்தையும் கிளோன் செய்யலாம்
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**சிலசார்பு**: **பிரதி அறிவிப்பு**:
இந்த ஆவணம் AI மொழிபெயர்ப்பு சேவையான [Co-op Translator](https://github.com/Azure/co-op-translator) மூலம் மொழிபெயர்க்கப்பட்டுள்ளது. நாங்கள் துல்லியத்துக்காக முயற்சிக்கிறோம் என்றாலும், தானியங்கி மொழிபெயர்ப்புகளில் பிழைகள் அல்லது தவறுகள் இருக்க வாய்ப்பு உள்ளது. அதன் உடன் மொழியில் உள்ள அசல் ஆவணம் அதிகாரப்பூர்வத் தாக்குத்தளமாக கருதப்பட வேண்டும். முக்கியமான தகவல்களுக்கு, தொழில்முறை மனித மொழிபெயர்ப்பு பரிந்துரைக்கப்படுகிறது. இந்த மொழிபெயர்ப்பின் பயன்பாட்டால் ஏற்பட்ட ஏதேனும் தவறான புரிதல்கள் அல்லது தவறான விளக்கங்களுக்கு நாங்கள் பொறுப்பில்லை. இந்த दस्तावेज़ம் AI மொழிபெயர்ப்பு சேவை [Co-op Translator](https://github.com/Azure/co-op-translator) மூலம் மொழிபெயர்க்கப்பட்டது. நாம் துல்லியத்திற்காக முயற்சித்தாலும், தானாக உருவாகும் மொழிபெயர்ப்புகளில் தவறுகள் அல்லது துல்லியமின்மைகள் இருக்கக்கூடும் என்பதை நினைவில் வைக்கவும். இதன் சொந்த மொழியில் உள்ள அசல் दस्तावेज़த்தை அதிகாரப்பூர்வ ஆதாரமாகக் கருத வேண்டும். முக்கியமான தகவல்களுக்கு, தொழில்முறை மனித மொழிபெயர்ப்பை பரிந்துரைக்கிறோம். இந்த மொழிபெயர்ப்பைப் பயன்படுத்துவதிலிருந்து உருவாகும் எந்த தவறான புரிதல்களுக்கும் அல்லது தவிர்க்கும் விளக்கங்களுக்கு நாங்கள் பொறுப்பேற்கமாட்டோம்.
<!-- CO-OP TRANSLATOR DISCLAIMER END --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->
Loading…
Cancel
Save