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

pull/1793/head
localizeflow[bot] 4 weeks ago
parent 2ef3acee53
commit 306cec0f79

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

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

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

@ -2,11 +2,11 @@
## 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
- **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
- **Interactive Quizzes**: 48 quizzes wey get 3 questions each (pre/post-lesson assessments)
- **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
- Educational repository with lesson-based structure
- Each lesson folder get README, code examples, and solutions
- Standalone projects for different directories (quiz-app, various lesson projects)
- Educational repository wey get lesson-based structure
- Every lesson folder get README, code examples, and solutions
- Standalone projects dey for separate directories (quiz-app, various lesson projects)
- 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
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
@ -46,7 +46,7 @@ npm run lint # Run ESLint
```bash
cd 7-bank-project/api
npm install
npm start # Start di API server
npm start # Start API server
npm run lint # Run ESLint
npm run format # Format wit Prettier
```
@ -81,28 +81,28 @@ python api.py
### For Content Contributors
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
4. Make changes to lesson content or code examples
5. Test any code changes for correct project directories
6. Submit pull requests wey follow contribution guidelines
4. Make changes for lesson content or code examples
5. Test any code changes inside the relevant project directories
6. Submit pull requests based on contribution guidelines
### For Learners
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
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
6. Complete assignments and challenges
7. Take post-lesson quizzes
6. Finish assignments and challenges
7. Do post-lesson quizzes
### Live Development
- **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
- **API Projects**: Run `npm start` for respective API directories
- **API Projects**: Run `npm start` for the API directories
## Testing Instructions
@ -111,81 +111,81 @@ python api.py
```bash
cd quiz-app
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
```bash
cd 7-bank-project/api
npm run lint # Check if code style get wahala
node server.js # Make sure server start without yawa
npm run lint # Check for code style wahala
node server.js # Make sure say server fit start without any kasala
```
### General Testing Approach
- Dis na educational repository wey no get full automated tests
- Manual testing focus on:
- Code examples dey run without error
- Dis na educational repository wey no get full automatic tests
- Manual testing dey focus on:
- Code examples dey run without wahala
- Links for documentation dey work well
- Project builds dey complete successful
- Examples dey follow best practices
- Project build dey complete successful
- Examples follow best practices
### Pre-submission Checks
- 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
- Confirm translations get proper structure
- Confirm say translations keep correct structure
## Code Style Guidelines
### JavaScript
- Use modern ES6+ syntax
- Follow standard ESLint configurations from projects
- Use meaningful variable and function names to help learners understand
- Add comments to explain concepts for learners
- Format using Prettier where e dey configured
- Follow standard ESLint config wey projects get
- Use meaningful variable and function names for educational clarity
- Add comments wey explain concepts for learners
- Format using Prettier if e dey setup
### HTML/CSS
- Use semantic HTML5 elements
- Responsive design principles
- Clear class naming conventions
- Comments to explain CSS techniques well for learners
- Comments wey dey explain CSS techniques for learners
### Python
- Follow PEP 8 style guidelines
- PEP 8 style guidelines
- Clear, educational code examples
- Put type hints where e dey useful for learning
- Type hints where e go help learning
### Markdown Documentation
- Clear heading hierarchy
- Code blocks wey specify language
- Links to more resources
- Screenshots and images for `images/` directories
- Code blocks with language specification
- Links to extra resources
- Screenshots and images inside `images/` directories
- Alt text for images to support accessibility
### File Organization
- Lessons dey number sequentially (1-getting-started-lessons, 2-js-basics, etc.)
- Every project get `solution/` and normally `start/` or `your-work/` directories
- Images dey inside lesson-specific `images/` folders
- Translations dey in `translations/{language-code}/` folders
- Lessons dey numbered one by one (1-getting-started-lessons, 2-js-basics, etc.)
- Every project get `solution/` and sometimes `start/` or `your-work/` directories
- Images for lesson-specific `images/` folders
- Translations dey inside `translations/{language-code}/` structure
## Build and Deployment
### 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
cd quiz-app
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:
@ -203,21 +203,21 @@ npm run convert # Make PDF from docs
### Docsify Documentation
```bash
npm install -g docsify-cli # Install Docsify for everywhere
docsify serve # Make e dey run for localhost:3000
npm install -g docsify-cli # Install Docsify all over di system
docsify serve # Run for localhost:3000
```
### Project-specific Builds
Each project fit get him own build process:
- Vue projects: Run `npm run build` to create production bundles
- Static projects: No build step, serve files directly
Every project directory fit get their own build process:
- Vue projects: `npm run build` dey create production bundles
- Static projects: No build step, just serve files directly
## Pull Request Guidelines
### 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`
- `[Lesson-3] Fix typo for terrarium project`
- `[Translation] Add Spanish translation for lesson 5`
@ -228,51 +228,51 @@ Use clear, descriptive titles wey show wetin you change:
Before you submit PR:
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
2. **Build Verification**:
- Run `npm run build` if e dey necessary
- Run `npm run build` if e necessary
- Make sure no build errors
3. **Link Validation**:
- Test all markdown links
- Confirm image references dey work
- Confirm image refs work
4. **Content Review**:
- Check for spelling and grammar mistakes
- Confirm code examples dey correct and educational
- Make sure translations maintain correct meaning
- Proofread for spelling and grammar
- Ensure code examples correct and educational
- Confirm translations keep original meaning
### Contribution Requirements
- You must agree to Microsoft CLA (automatic check for first PR)
- Follow the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- See [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed rules
- Reference issue numbers for PR description if e relate
- Agree to Microsoft CLA (automatic check for first PR)
- Follow [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- See [CONTRIBUTING.md](./CONTRIBUTING.md) for details
- Reference issue numbers for PR description if e get
### Review Process
- Maintainers and community go review PRs
- Educational clarity dey priority
- Code examples suppose follow current best practice
- Translations go review for accuracy and cultural fit
- PRs go through maintainer and community review
- Educational clarity dey important
- Code examples suppose follow current best practices
- Translations go through accuracy and cultural appropriateness check
## Translation System
### Automated Translation
- Dey use GitHub Actions with co-op-translator workflow
- Translates automatically to 50+ languages
- Translates to 50+ languages automatically
- Source files dey main directories
- Translated files dey `translations/{language-code}/` folders
- Translated files dey inside `translations/{language-code}/`
### Adding Manual Translation Improvements
1. Find the file for `translations/{language-code}/`
2. Make improvements without changing structure
3. Check say code examples still dey work
4. Test localized quiz content
1. Find file for `translations/{language-code}/`
2. Make improvements but keep structure intact
3. Make sure code examples still dey run well
4. Test any quiz content wey localized
### Translation Metadata
@ -293,99 +293,99 @@ CO_OP_TRANSLATOR_METADATA:
### Common Issues
**Quiz app no dey start**:
- Check Node.js version (v14+ na better)
**Quiz app no fit start**:
- Check Node.js version (v14+ recommended)
- 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**:
- Make sure Node.js version dey ok (node >=10)
- Check if port dey busy
- Confirm say all dependencies install with `npm install`
**API server no go start**:
- Confirm Node.js version dey at least (node >=10)
- Check if port don already dey use
- Make sure all dependencies install with `npm install`
**Browser extension no dey load**:
- Check manifest.json format correct
**Browser extension no go load**:
- Confirm manifest.json format correct
- Check browser console for errors
- Follow browser-specific extension installation guide
- Follow browser extension installation instructions
**Python chat project problems**:
- Make sure OpenAI package install: `pip install openai`
- Confirm GITHUB_TOKEN environment variable dey set
- Check GitHub Models access permissions
**Python chat project wahala**:
- Confirm OpenAI package install: `pip install openai`
- Confirm GITHUB_TOKEN environment variable set
- Check GitHub Models permission
**Docsify no dey serve docs**:
- Install docsify-cli globally: `npm install -g docsify-cli`
- Run am from repository root folder
- Check that `docs/_sidebar.md` dey
- Run am from root directory
- Check say `docs/_sidebar.md` dey
### Development Environment Tips
- Use VS Code with Live Server extension for HTML projects
- Install ESLint and Prettier extensions for uniform formatting
- Use browser DevTools for debugging JavaScript
- Install ESLint and Prettier extensions for proper formatting
- Use browser DevTools for JavaScript debugging
- For Vue projects, install Vue DevTools browser extension
### Performance Considerations
- Plenty translated files (50+ languages) mean clone go big
- Use shallow clone if you just want content: `git clone --depth 1`
- When you dey work on English content, exclude translations from search
- Build fit take time first time (npm install, Vite build)
- Plenty translated files (50+ languages) mean big clones
- Use shallow clone if na content only: `git clone --depth 1`
- Exclude translations from searches if you dey focus on English
- Build steps fit slow for first time (npm install, Vite build)
## Security Considerations
### Environment Variables
- API keys no suppose enter repository commit
- Use `.env` files (dem already inside `.gitignore`)
- Document environment variables wey project need for README
- API keys no suppose commit to repository
- Use `.env` files (already for `.gitignore`)
- Document needed environment variables inside project READMEs
### Python Projects
- Use virtual environments: `python -m venv venv`
- Keep dependencies up to date
- GitHub tokens get to get smallest necessary permissions
- Keep dependencies updated
- GitHub tokens need minimal permissions
### GitHub Models Access
- Personal Access Tokens (PAT) dey needed for GitHub Models
- Keep tokens as environment variables
- No ever commit tokens or credentials
- Personal Access Tokens (PAT) required for GitHub Models
- Tokens suppose dey stored as environment variables
- Never commit tokens or credentials
## Additional Notes
### Target Audience
- Complete beginners wey dey learn web development
- Students and people wey dey learn by themselves
- Teachers wey dey use curriculum for classroom
- Content designed for accessibility and gradual skill building
- Complete beginners to web development
- Students and self-learners
- Teachers wey use the curriculum for classroom
- Content dey designed for accessibility and gradual skill building
### Educational Philosophy
- Project-based learning style
- Frequent knowledge checks (quizzes)
- Hands-on coding exercises
- Real-world application examples
- Real-life application examples
- Focus on fundamentals before frameworks
### Repository Maintenance
- Active community of learners and contributors
- Regular update to dependencies and content
- Active learner and contributor community
- Regular updates to content and dependencies
- Maintainers dey monitor issues and discussions
- Translation updates dey automatic with GitHub Actions
- Translation updates automated via GitHub Actions
### Related Resources
- [Microsoft Learn modules](https://docs.microsoft.com/learn/)
- [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
### 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
- `7-bank-project/README.md` - Banking app with authentication
- `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
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
- Projects no dey share dependencies
- You fit work on each project separately without disturbing others
- Clone whole repo if you wan complete curriculum experience
- You fit work on individual projects without affect others
- Clone whole repo for full curriculum experience
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**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 -->

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

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