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

pull/1774/head
localizeflow[bot] 3 weeks ago
parent 0d7e8ebe9d
commit 3be5a46118

@ -1,7 +1,7 @@
{
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8",
"translation_date": "2026-03-06T15:30:44+00:00",
"original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-27T23:19:21+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "et"
},
@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T15:39:39+00:00",
"translation_date": "2026-03-27T23:23:44+00:00",
"source_file": "AGENTS.md",
"language_code": "et"
},

@ -2,36 +2,36 @@
## Projekti ülevaade
See on hariduslik õppekava hoidla veebiarenduse põhialuste õpetamiseks algajatele. Õppekava on põhjalik 12-nädalane kursus, mille on välja töötanud Microsoft Cloud Advocates, pakkudes 24 praktilist tundi, mis hõlmavad JavaScripti, CSS-i ja HTML-i.
See on hariduslik õppekava hoidla, mis on mõeldud veebiarenduse põhimõtete õpetamiseks algajatele. Õppekava on Microsoft Cloud Advocates'i loodud põhjalik 12-nädalane kursus, mis sisaldab 24 praktilist õppetundi JavaScripti, CSS-i ja HTML-i kohta.
### Põhikomponendid
### Peamised komponendid
- **Hariduslik sisu**: 24 struktureeritud tundi, mis on organiseeritud projektipõhistesse moodulitessse
- **Praktilised projektid**: terrarium, tippmäng, brauserilaiendus, kosmose-mäng, pangarakendus, koodiredaktor ja tehisintellekti vestlusassistent
- **Interaktiivsed viktoriinid**: 48 viktoriini, igaühes 3 küsimust (enne ja pärast tundi)
- **Mitmekeelne tugi**: automatiseeritud tõlked üle 50 keelde GitHub Actions abil
- **Tehnoloogiad**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (tehisintellekti projektide jaoks)
- **Hariduslik sisu**: 24 struktureeritud õppetundi, mis on korraldatud projektipõhistesse moodulitesse
- **Praktilised projektid**: Terrarium, Tippmäng, Brauserilaiendus, Kosmosemäng, Panga rakendus, Koodiredaktor ja AI juturobot
- **Interaktiivsed viktoriinid**: 48 viktoriini, igaühes 3 küsimust (enne ja pärast õppetundi)
- **Mitmekeelne tugi**: Automaatne tõlge 50+ keelde GitHub Actionsi kaudu
- **Tehnoloogiad**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI projektide jaoks)
### Arhitektuur
- Hariduslik hoidla õppetundide-põhise struktuuriga
- Iga õppetunni kaust sisaldab README-d, koodinäiteid ja lahendusi
- Sõltumatud projektid eraldiseisvates kataloogides (quiz-app, erinevad õppetundide projektid)
- Tõlkesüsteem kasutades GitHub Actionsi (co-op-translator)
- Dokumentatsioon on kättesaadav Docsify kaudu ja PDF-formaadis
- Hariduslik hoidla õppetundide struktuuriga
- Igas õppetunni kaustas on README, koodi näited ja lahendused
- Iseseisvad projektid eraldi kataloogides (quiz-app, erinevad õppetundi projektid)
- Tõlkesüsteem kasutades GitHub Actionsi (co-op-translator)
- Dokumentatsioon serveeritakse Docsify abil ja on saadaval PDF-ina
## Paigaldamiskäsud
## Seadistus-käsud
See hoidla on peamiselt mõeldud haridusliku sisu tarbimiseks. Konkreetselt projektidega töötamiseks:
See hoidla on peamiselt mõeldud haridusliku sisu tarbimiseks. Konkreetsete projektidega töötamiseks:
### Peahoidla seadistamine
### Peahoidla seadistus
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### Viktoriini rakenduse seadistamine (Vue 3 + Vite)
### Viktoriini rakenduse seadistus (Vue 3 + Vite)
```bash
cd quiz-app
@ -56,10 +56,10 @@ npm run format # Vorminda Prettieriga
```bash
cd 5-browser-extension/solution
npm install
# Järgige brauseri-põhiseid laienduse laadimise juhiseid
# Järgige brauserispetsiifilisi laienduste laadimise juhiseid
```
### Kosmose mänguprojektid
### Kosmosemängu projektid
```bash
cd 6-space-game/solution
@ -67,42 +67,42 @@ npm install
# Ava index.html brauseris või kasuta Live Serverit
```
### Vestluse projekt (Python backend)
### Jutu projekt (Python backend)
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# Määra GITHUB_TOKEN keskkonnamuutuja
# Sea GITHUB_TOKEN keskkonnamuutuja
python api.py
```
## Arendusprotsess
## Arenduse töövoog
### Sisu panustajatele
### Sisu kaasautoritele
1. **Hargne hoidla** oma GitHubi kontole
2. **Klooni oma haru** lokaalselt
2. **Kloonige oma hargnevus lokaalselt**
3. **Loo uus haru** oma muudatuste jaoks
4. Tee muudatusi õppetundide sisus või koodinäidetes
5. Testi kõiki koodimuudatusi vastavates projektikataloogides
6. Esita pull request'id vastavalt panustamise juhistele
4. Tee muudatusi õppetundide sisus või koodi näidetes
5. Testi koodimuudatusi vastavates projektikaustades
6. Esita pull-päringud vastavalt panustamisjuhistele
### Õppijatele
### Õppuritele
1. Hargne või klooni hoidla
2. Liigu õppetundide kataloogides järjestikku
2. Liigu õppetundide kaustades järjestikku
3. Loe iga õppetunni README faile
4. Tee ette-viktoriinid aadressil https://ff-quizzes.netlify.app/web/
5. Töötle läbi koodinäited õppetundide kaustades
4. Täida enne õppetundi viktoriinid aadressil https://ff-quizzes.netlify.app/web/
5. Töötle läbi koodi näited õppetundide kaustades
6. Täida ülesanded ja väljakutsed
7. Tee järel-viktoriinid
7. Tee pärast õppetundi viktoriinid
### Reaalajas arendus
- **Dokumentatsioon**: käivita `docsify serve` juurkataloogis (port 3000)
- **Dokumentatsioon**: käivita juurkataloogis `docsify serve` (port 3000)
- **Viktoriini rakendus**: käivita `npm run dev` quiz-app kataloogis
- **Projektid**: kasuta VS Code Live Server laiendust HTML projektide jaoks
- **API projektid**: käivita `npm start` vastavates API kataloogides
- **API projektid**: käivita vastavates API kataloogides `npm start`
## Testimise juhised
@ -110,8 +110,8 @@ python api.py
```bash
cd quiz-app
npm run lint # Kontrolli koodistiili probleeme
npm run build # Kontrolli, kas ehitus õnnestub
npm run lint # Kontrolli koodistiili rikkumisi
npm run build # Kontrolli, et ehitus õnnestub
```
### Panga API testimine
@ -119,109 +119,109 @@ npm run build # Kontrolli, kas ehitus õnnestub
```bash
cd 7-bank-project/api
npm run lint # Kontrolli koodistiili probleeme
node server.js # Kontrolli, et server käivituks ilma vigadeta
node server.js # Kontrolli, kas server käivitub ilma vigadeta
```
### Üldine testimise lähenemine
### Üldine testimisstrateegia
- See on hariduslik hoidla ilma ulatuslike automatiseeritud testideta
- Tegemist on haridusliku hoidla, millel ei ole põhjalikke automaatseid teste
- Käsitsi testimine keskendub:
- Koodinäited jooksevad ilma vigadeta
- Dokumendis olevad lingid toimivad korrektselt
- Projektide ehitused õnnestuvad
- Näited järgivad parimaid tavasid
- Koodinäidete töötamisele ilma vigadeta
- Dokumentatsiooni linkide õigele toimimisele
- Projektide edukale ehitamisele
- Näidete parimate tavade järgimisele
### Enne esitamist kontrollid
### Enne esitamise kontrollid
- Käivita `npm run lint` kataloogides, kus on package.json
- Kontrolli, et markdown lingid on kehtivad
- Testi koodinäiteid brauseris või Node.js keskkonnas
- Veendu, et tõlked säilitavad õige struktuuri
- Kontrolli markdown linkide kehtivust
- Testi koodi näiteid brauseris või Node.js keskkonnas
- Veendu, et tõlked hoiaksid õiget struktuuri
## Koodi stiili juhised
### JavaScript
- Kasuta kaasaegset ES6+ süntaksit
- Järgi projektides pakutud ESLint konfiguratsioone
- Kasuta tähenduslikke muutujate ja funktsioonide nimesid haridusliku selguse tagamiseks
- Lisa kommentaare mõistete selgitamiseks õppijatele
- Vorminda Prettieriga seal, kus on seadistatud
- Järgi projektides määratud tavapäraseid ESLint konfiguratsioone
- Kasuta tähenduslikke muutujate ja funktsioonide nimesid haridusliku selguse jaoks
- Lisa kommentaare, mis selgitavad kontseptsioone õppijatele
- Vorminda Prettier abil seal, kus see on seadistatud
### HTML/CSS
- Semantiline HTML5 elemendid
- Reageeriv disaini põhimõtted
- Selged klassinimede konventsioonid
- Kommentaarid, mis selgitavad CSS-tehnikaid õppijatele
- Semantiline HTML5 elementide kasutus
- Reageeriva disaini põhimõtted
- Selged klassinime konventsioonid
- Kommentaarid, mis selgitavad CSS tehnikaid õppuritele
### Python
- PEP 8 stiilijuhised
- Selged, hariduslikud koodinäited
- Tüüpi vihjed sealsamas, kus need aitavad õppimisel
- Tüübiviited seal, kus need aitavad õppimist
### Markdown dokumentatsioon
- Selge pealkirjade hierarhia
- Koodiblokid keelega märgistatud
- Lingid lisamaterjalide juurde
- Selge päiste hierarhia
- Koodiblokid koos keele määratlusega
- Lingid lisamaterjalidele
- Ekraanipildid ja pildid `images/` kataloogides
- Piltide alt-tekst ligipääsetavuseks
- Piltide alt-tekst ligipääsetavuse tagamiseks
### Failide organiseerimine
### Failide korraldus
- Õppetunnid nummerdatud järjestikku (1-getting-started-lessons, 2-js-basics jne)
- Igal projektil on `solution/` ja tihti ka `start/` või `your-work/` kataloogid
- Pildid talletatud konkreetse õppetunni `images/` kaustas
- Tõlked `translations/{language-code}/` struktuuris
- Õppetunnid numbritega järjestatud (nt 1-getting-started-lessons, 2-js-basics jne)
- Igal projektil on `solution/` ja tihti `start/` või `your-work/` kataloogid
- Pildid salvestatud õppetundide eripärastesse `images/` kaustadesse
- Tõlked asuvad `translations/{language-code}/` struktuuris
## Buildimine ja juurutamine
## Ehitamine ja juurutamine
### Viktoriini rakenduse juurutamine (Azure Static Web Apps)
### Viktoriinirakenduse juurutamine (Azure Static Web Apps)
Quiz-app on seadistatud Azure Static Web Apps-ile juurutamiseks:
quiz-app on seadistatud Azure Static Web Apps juurutamiseks:
```bash
cd quiz-app
npm run build # Loob kausta dist/
# Rakendab GitHub Actionsi töövoo kaudu pushi korral põhisagarasse
# Teostab juurutamise GitHub Actions töövoo kaudu pushi korral main harusse
```
Azure Static Web Apps konfiguratsioon:
- **Rakenduse asukoht**: `/quiz-app`
- **Väljundkaust**: `dist`
- **Väljundi asukoht**: `dist`
- **Töövoog**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Dokumentatsiooni PDF genereerimine
```bash
npm install # Installi docsify-to-pdf
npm install # Paigalda docsify-to-pdf
npm run convert # Genereeri PDF docsist
```
### Docsify dokumentatsioon
```bash
npm install -g docsify-cli # Paigalda Docsify ülemaailmselt
docsify serve # Serveeri lokaalselt aadressil localhost:3000
npm install -g docsify-cli # Installi Docsify globaalselt
docsify serve # Serveeri aadressil localhost:3000
```
### Projektipõhised ehitused
Igal projekti kataloogil võib olla oma ehitusprotsess:
- Vue projektid: `npm run build` loob tootmiseks valmis paketid
- Staatilised projektid: ehitusastet ei ole, serveeritakse failid otse
Igal projektil võib olla oma ehitusprotsess:
- Vue projektid: `npm run build` loob tootmise komplektid
- Staatilised projektid: pole ehitusetappi, failid serveeritakse otse
## Pull Request'i juhised
## Pull-päringu juhised
### Pealkirja formaat
Kasuta selgeid ja kirjeldavaid pealkirju, mis näitavad muudatuse ala:
- `[Quiz-app] Lisa uus viktoriin õppetunni X jaoks`
- `[Lesson-3] Paranda trükiviga terrarium projekti juures`
- `[Translation] Lisa hispaania keelne tõlge õppetunnile 5`
- `[Docs] Uuenda paigaldusjuhiseid`
Kasuta selgeid, kirjeldavaid pealkirju, mis näitavad muudatuse valdkonda:
- `[Quiz-app] Lisa uus viktoriin õppetund X jaoks`
- `[Lesson-3] Paranda kirjaviga terrarium projektis`
- `[Translation] Lisa hispaania tõlge õppetund 5 jaoks`
- `[Docs] Uuenda seadistusjuhiseid`
### Nõutavad kontrollid
@ -231,52 +231,52 @@ Enne PR-i esitamist:
- Käivita `npm run lint` mõjutatud projektikataloogides
- Paranda kõik lintimise vead ja hoiatused
2. **Buildi kontroll**:
- Käivita `npm run build`, kui see on aktuaalne
- Veendu, et build ei viska vigu
2. **Ehituse kontroll**:
- Käivita `npm run build`, kui see on kohaldatav
- Veendu, et ehitus on edukas
3. **Lingide valideerimine**:
- Testi kõiki markdown linke
3. **Linkide valideerimine**:
- Testi kõik markdown lingid
- Kontrolli pildiviiteid
4. **Sisu ülevaatus**:
- Paranda õigekirja ja grammatika vead
- Veendu, et koodinäited on õiged ja hariduslikud
- Kontrolli, et tõlked säilitavad algse tähenduse
- Keele- ja õigekirjakontroll
- Veendu, et koodi näited on õiged ja hariduslikud
- Kontrolli, et tõlked säilitavad originaalse tähenduse
### Panustamise nõuded
- Nõustu Microsoft CLA-ga (automaatne kontroll esimesel PR-il)
- Järgi [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Vaata [CONTRIBUTING.md](./CONTRIBUTING.md) üksikasjalike juhiste jaoks
- Viita issue numbritele PR kirjelduse juures, kui sobib
- Nõustu Microsofti CLA-ga (esimese PR-i automatiseeritud kontroll)
- Järgi [Microsofti avatud lähtekoodi käitumisreegleid](https://opensource.microsoft.com/codeofconduct/)
- Vaata üksikasjalikke juhiseid [CONTRIBUTING.md](./CONTRIBUTING.md) failist
- Viita PR kirjelduse juures vajadusel probleemide numbritele
### Ülevaatusprotsess
- PR-id üle vaatavad hooldajad ja kogukond
- Hariduslik selgus on esimene prioriteet
- Koodinäited peaksid järgima parimaid tavasid
- Tõlked kontrollitakse täpsuse ja kultuurilise sobivuse osas
- PR-sid vaatavad läbi hooldajad ja kogukond
- Prioriteediks on hariduslik selgus
- Koodi näited peavad järgima hetke parimaid praktikaid
- Tõlgetel on ülevaatus täpsuse ja kultuurilise sobivuse tagamiseks
## Tõlkesüsteem
### Automatiseeritud tõlge
### Automaatne tõlge
- Kasutab GitHub Actionsi koos co-op-translator töövooga
- Tõlgib automaatselt üle 50 keelde
- Allikfailid paiknevad peakaustades
- Tõlgitud failid on `translations/{language-code}/` kataloogides
- Kasutab GitHub Actionsi koos co-op-translator töövooga
- Tõlgib automaatselt 50+ keelde
- Allikafailid on põhikaustades
- Tõlgitud failid asuvad `translations/{language-code}/` kataloogides
### Käsitsi tõlke parenduste lisamine
### Käsitsi tõlkeparanduste lisamine
1. Leia fail kataloogist `translations/{language-code}/`
2. Tee parendused, säilitades struktuuri
3. Veendu, et koodinäited jäävad töökorras
4. Testi kõiki lokaliseeritud viktoriine
1. Leia fail `translations/{language-code}/` kataloogist
2. Tee parandused, hoides struktuuri
3. Veendu, et koodi näited töötavad jätkuvalt
4. Testi kõiki kohandatud viktoriini sisu osi
### Tõlke metaandmed
Tõlgitud failid sisaldavad metaandmetega päist:
Tõlgitud failidel on metaandmete päis:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -289,68 +289,68 @@ CO_OP_TRANSLATOR_METADATA:
-->
```
## Silumine ja tõrkeotsing
## Silumine ja probleemide lahendamine
### Levinumad probleemid
**Viktoriini rakendus ei käivitu**:
- Kontrolli Node.js versiooni (soovitatav v14+)
- Kustuta `node_modules` ja `package-lock.json`, käivita uuesti `npm install`
- Kontrolli portide konflikte (vaikimisi: Vite kasutab porti 5173)
**Viktoriinirakendus ei käivitu**:
- Kontrolli Node.js versiooni (soovituslik v14+)
- Kustuta `node_modules` ja `package-lock.json`, käivita `npm install` uuesti
- Kontrolli pordikonflikte (vaikimisi: Vite kasutab porti 5173)
**API server ei käivitu**:
- Veendu, et Node.js versioon on piisavalt uus (node >=10)
- Kontrolli, et Node.js versioon on vähemalt 10 või uuem
- Kontrolli, kas port on juba hõivatud
- Veendu, et kõik sõltuvused on paigaldatud käsuga `npm install`
- Veendu, et kõik sõltuvused on paigaldatud `npm install` abil
**Brauserilaiendust ei laadita**:
- Kontrolli, et manifest.json on korrektselt vormistatud
- Vaata brauseri konsoolist vigu
- Järgi brauseri-spetsiifilisi laienduse paigaldusjuhiseid
**Brauserilaiendus ei lae**:
- Kontrolli, et manifest.json on õigesti vormistatud
- Vaata brauseri konsoolist veateateid
- Järgi brauseripõhiseid laienduse paigaldusjuhiseid
**Python vestluse projekti probleemid**:
**Python juturoboti probleemid**:
- Veendu, et OpenAI pakett on paigaldatud: `pip install openai`
- Veendu, et GITHUB_TOKEN keskkonnamuutuja on seadistatud
- Kontrolli GitHubi mudelite kasutusõigusi
- Kontrolli, et GITHUB_TOKEN keskkonnamuutuja on seatud
- Kontrolli GitHub mudelitele juurdepääsu õigusi
**Docsify ei serveeri dokumentatsiooni**:
**Docsify ei serveeri dokumente**:
- Paigalda docsify-cli globaalselt: `npm install -g docsify-cli`
- Käivita hoidla juurkataloogist
- Kontrolli, et `docs/_sidebar.md` fail eksisteerib
- Kontrolli, et fail `docs/_sidebar.md` on olemas
### Arenduskeskkonna näpunäited
- Kasuta VS Codei Live Server laiendust HTML projektide jaoks
- Paigalda ESLint ja Prettier laiendused vorminduse järjepidevuseks
- Kasuta brauseri DevToolsi JavaScripti silumiseks
- Vue projektide jaoks paigalda Vue DevTools brauserilaiendus
- Kasuta VS Codei koos Live Server laiendusega HTML projektide jaoks
- Paigalda ESLint ja Prettier laiendused ühtlaseks vormindamiseks
- Kasuta brauseri arendustööriistu JavaScripti silumiseks
- Vue projektide puhul paigalda Vue DevTools brauserilaiendus
### Jõudluse kaalutlused
- Suur hulk tõlgitud faile (üle 50 keele) muudab kloonid suurt e mahukaks
- Kasuta ligikaudset klooni, kui töötad ainult sisuga: `git clone --depth 1`
- Välista tõlked otsingutest, kui töötad ingliskeelse sisuga
- Ehitusprotsessid võivad olla esmakordsel käivitamisel aeglased (npm install, Vite ehitus)
- Palju tõlgitud faile (50+ keeltes) tähendab suurt klooni suurust
- Kasuta madalat klooni, kui töötad ainult sisuga: `git clone --depth 1`
- Väldi tõlgete otsimist, kui keskendud inglisekeelsele sisule
- Ehitused võivad esimesel korral olla aeglased (npm install, Vite build)
## Turvalisuse kaalutlused
### Keskkonnamuutujad
- API võtmeid ei tohi kunagi hoidlas hoida
- Kasuta `.env` faile (mis on juba `.gitignore`-s)
- Dokumendeeri nõutud keskkonnamuutujad projektide README-des
- API võtmeid ei tohi kunagi hoidlasse panna
- Kasuta `.env` faile (juba `.gitignore`-s)
- Dokumenteeri nõutud keskkonnamuutujad projekti READMEs
### Python projektid
- Kasuta virtuaalkeskkonda: `python -m venv venv`
- Kasuta virtuaalset keskkonda: `python -m venv venv`
- Hoia sõltuvused ajakohased
- GitHubi tokenitel peaks olema minimaalne vajalik ligipääs
- GitHubi tokenid peaksid omama minimaalseid vajalikke õigusi
### GitHub mudelite ligipääs
### GitHub mudelitele juurdepääs
- GitHubi mudelite jaoks on vaja isiklikke juurdepääsu võtmeid (PAT)
- Tokeneid hoitakse keskkonnamuutujatena
- Ära kunagi pane tokeneid või mandaate hoidla külge
- GitHub mudelite jaoks on vajalikud personaalsed juurdepääsutokenid (PAT)
- Tokenid tuleks hoida keskkonnamuutujatena
- Ära kunagi pane tokenit või mandaate hoidla hulka
## Lisamärkused
@ -359,50 +359,50 @@ CO_OP_TRANSLATOR_METADATA:
- Täielikud algajad veebiarenduses
- Üliõpilased ja iseseisvad õppijad
- Õpetajad, kes kasutavad õppekava klassiruumis
- Sisu on loodud ligipääsetavaks ja oskuste järkjärgulise kasvatamise jaoks
- Sisu on loodud ligipääsetavaks ning oskuste järkjärguliseks arendamiseks
### Haridusfilosoofia
### Haridusalane filosoofia
- Projektipõhine õppekava lähenemine
- Sageli teadmiste kontrollid (viktoriinid)
- Projektipõhine õppe lähenemine
- Sageli toimuvad teadmiste kontrollid (viktoriinid)
- Praktilised kodeerimisharjutused
- Reaalmaailma rakenduste näited
- Fookus põhialustel enne raamistikke
- Keskendumine põhitõdedele enne raamistikke
### Hoidla hooldus
- Aktiivne õppijate ja panustajate kogukond
- Aktiivne kogukond õppijate ja panustajatega
- Regulaarne sisu ja sõltuvuste uuendamine
- Hoiatuste ja arutelude jälgimine hooldajate poolt
- Tõlgete automatiseeritud uuendamine GitHub Actionsi kaudu
- Hooldajad jälgivad issue-sid ja arutelusid
- Tõlkete uuendused on automatiseeritud GitHub Actionsi 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
- Lisakursused: Generatiivne AI, Andmeteadus, ML, IoT õppekavad olemas
- [Õpilaskeskuse ressursid](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) soovitatav õppuritele
- Täiendavad kursused: Generatiivne AI, Andmeteadus, ML, IoT õppekavad saadaval
### Töötamine konkreetsete projektidega
Üksikasjaliku juhendi leiad iga projekti README failidest:
Üksikasjalike juhiste jaoks üksikprojektidele vaata READMEsid:
- `quiz-app/README.md` - Vue 3 viktoriinirakendus
- `7-bank-project/README.md` - Panga rakendus koos autentimisega
- `5-browser-extension/README.md` - Brauserilaienduse arendus
- `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` - Tehisintellekti vestlusassistendi projekt
- `9-chat-project/README.md` - AI juturoboti projekt
### Monorepo struktuur
Kuigi ei ole traditsiooniline monorepo, sisaldab see hoidla mitut sõltumatut projekti:
Kuigi see ei ole traditsiooniline monorepo, sisaldab see hoidla mitut sõltumatut projekti:
- Iga õppetund on iseseisev
- Projektid ei jaga sõltuvusi
- Töötada saab iga projektiga iseseisvalt, ilma teistele mõjuta
- Klooni kogu hoidla, et saada täielik õppekogemus
- Projektidel pole ühiseid sõltuvusi
- Töötada saab eraldi projektide kallal ilma teistele mõjuta
- Klooni kogu hoidla kogu õppekava kogemuse saamiseks
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Tähelepanek**:
See dokument on tõlgitud kasutades tehisintellekti tõlketeenust [Co-op Translator](https://github.com/Azure/co-op-translator). Kuigi püüame tagada täpsust, palun arvestage, et automaatsed tõlked võivad sisaldada vigu või ebatäpsusi. Originaaldokument selle emakeeles tuleks pidada usaldusväärseks allikaks. Olulise teabe puhul soovitatakse professionaalset inimtõlget. Me ei vastuta selle tõlke kasutamisest tulenevate arusaamatuste ega valesti mõistmiste eest.
**Vastutusest loobumine**:
See dokument on tõlgitud, kasutades AI tõlketeenust [Co-op Translator](https://github.com/Azure/co-op-translator). Kuigi me püüdleme täpsuse poole, palun pange tähele, et automaatsed tõlked võivad sisaldada vigu või ebatäpsusi. Originaaldokument selle emakeeles tuleks pidada autoriteetseks allikaks. Olulise teabe puhul soovitatakse kasutada professionaalset inimtõlget. Me ei vastuta selle tõlke kasutamisest tekkida võivate arusaamatuste või valesti mõistmiste eest.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -1,7 +1,7 @@
{
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8",
"translation_date": "2026-03-06T15:37:07+00:00",
"original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-27T23:21:49+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "pcm"
},
@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T15:40:35+00:00",
"translation_date": "2026-03-27T23:24:28+00:00",
"source_file": "AGENTS.md",
"language_code": "pcm"
},

@ -2,27 +2,27 @@
## Project Overview
Dis na educational curriculum repository wey dem use teach web development fundamentals to pipul wey never sabi before. Di curriculum na beta 12-week course wey Microsoft Cloud Advocates develop, e get 24 hands-on lessons wey dey cover JavaScript, CSS, and HTML.
Dis na educational curriculum repository wey dem take teach web development fundamentals to beginners. Di curriculum na comprehensive 12-week course wey Microsoft Cloud Advocates develop, wey get 24 hands-on lessons wey cover JavaScript, CSS, and HTML.
### Key Components
- **Educational Content**: 24 structured lessons wey dem organize inside project-based modules
- **Educational Content**: 24 structured lessons wey dem organize into 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 (before and after lesson assessments)
- **Multi-language Support**: Automatic translations for 50+ languages using GitHub Actions
- **Interactive Quizzes**: 48 quizzes wey get 3 questions each (pre/post-lesson assessments)
- **Multi-language Support**: Automated translations for 50+ languages via GitHub Actions
- **Technologies**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (for AI projects)
### Architecture
- Educational repository get lesson-based structure
- Every lesson folder get README, code examples, and solutions
- Standalone projects dey for separate directories (quiz-app, different lesson projects)
- Translation system wey use GitHub Actions (co-op-translator)
- Documentation dey serve via Docsify and e dey available as PDF
- Educational repository wey get lesson-based structure
- Each lesson folder dey contain README, code examples, and solutions
- Standalone projects dey for separate directories (quiz-app, various lesson projects)
- Translation system wey dey use GitHub Actions (co-op-translator)
- Documentation na Docsify e serve and e dey available as PDF
## Setup Commands
Dis repository na mainly for educational content consumption. If you wan work with particular projects:
Dis repository na mainly for educational content consumption. If you wan work with specific projects:
### Main Repository Setup
@ -36,7 +36,7 @@ cd Web-Dev-For-Beginners
```bash
cd quiz-app
npm install
npm run dev # Start de development server
npm run dev # Start di development server
npm run build # Build for production
npm run lint # Run ESLint
```
@ -48,7 +48,7 @@ cd 7-bank-project/api
npm install
npm start # Start di API server
npm run lint # Run ESLint
npm run format # Arrange wit Prettier
npm run format # Format wit Prettier
```
### Browser Extension Projects
@ -56,7 +56,7 @@ npm run format # Arrange wit Prettier
```bash
cd 5-browser-extension/solution
npm install
# Follow browser-specific extension loading instructions
# Follow di way wey each browser de load extensions
```
### Space Game Projects
@ -80,29 +80,29 @@ python api.py
### For Content Contributors
1. **Fork di repository** go your GitHub account
2. **Clone your fork** for your local machine
3. **Create new branch** for the changes wey you wan do
1. **Fork di repository** to your GitHub account
2. **Clone your fork** locally
3. **Create new branch** for your changes
4. Make changes to lesson content or code examples
5. Test any code changes inside the project directories wey concern am
6. Submit pull requests based on contribution guidelines
5. Test any code changes inside relevant project directories
6. Submit pull requests according to contribution guidelines
### For Learners
1. Fork or clone di repository
2. Go through lesson directories one by one
2. Enter 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. Complete pre-lesson quizzes for https://ff-quizzes.netlify.app/web/
5. Work through code examples inside lesson folders
6. Complete assignments and challenges
6. Finish assignments and challenges
7. Take post-lesson quizzes
### Live Development
- **Documentation**: Run `docsify serve` for root (port 3000)
- **Quiz App**: Run `npm run dev` inside quiz-app directory
- **Quiz App**: Run `npm run dev` for quiz-app directory
- **Projects**: Use VS Code Live Server extension for HTML projects
- **API Projects**: Run `npm start` inside the API directories wey concern am
- **API Projects**: Run `npm start` for each API directories
## Testing Instructions
@ -111,7 +111,7 @@ python api.py
```bash
cd quiz-app
npm run lint # Check for code style wahala
npm run build # Make sure say build go succeed
npm run build # Make sure build teyari fine
```
### Bank API Testing
@ -119,24 +119,24 @@ npm run build # Make sure say build go succeed
```bash
cd 7-bank-project/api
npm run lint # Check for code style wahala
node server.js # Make sure server start without gbege
node server.js # Make sure server start fine without gbege
```
### General Testing Approach
- Na educational repository dis, e no get full automated tests
- Dis na educational repository wey no get comprehensive automated tests
- Manual testing dey focus on:
- Code examples dey run without error
- Links for documentation dey work well
- Projects dey build successful
- Examples follow beta practices
- Code examples run without errors
- Links wey dey documentation dey work well
- Project builds complete successful
- Examples dey follow best practices
### Pre-submission Checks
- Run `npm run lint` inside directories wey get package.json
- Make sure markdown links dey valid
- Run `npm run lint` for directories wey get package.json
- Check sey markdown links valid
- Test code examples for browser or Node.js
- Make sure translations keep proper structure
- Confirm translations get proper structure
## Code Style Guidelines
@ -144,48 +144,48 @@ node server.js # Make sure server start without gbege
- Use modern ES6+ syntax
- Follow standard ESLint configurations wey dey projects
- Use correct variable and function names so that e clear for education
- Add comments to explain concepts for learners
- Use Prettier for formatting where e configure
- Use meaningful variable and function names for educational clarity
- Add comments wey explain concepts for learners
- Format use Prettier where e set
### HTML/CSS
- Use semantic HTML5 elements
- Semantic HTML5 elements
- Responsive design principles
- Clear class naming conventions
- Comments to explain CSS techniques for learners
- Comments wey explain CSS techniques for learners
### Python
- Follow PEP 8 style guidelines
- Clear and educational code examples
- Use type hints when e go help learning
- PEP 8 style guidelines
- Clear, educational code examples
- Type hints where e dey helpful for learning
### Markdown Documentation
- Clear heading hierarchy
- Code blocks with language specification
- Code blocks wey get language specification
- Links to extra resources
- Screenshots and images dey for `images/` directories
- Screenshots and images for `images/` directories
- Alt text for images for accessibility
### File Organization
- Lessons dey numbered in order (1-getting-started-lessons, 2-js-basics, etc.)
- Every project get `solution/` and sometimes `start/` or `your-work/` directories
- Images dey for lesson-specific `images/` folders
- Translations dey inside `translations/{language-code}/` folder structure
- Lessons dem number one by one (1-getting-started-lessons, 2-js-basics, etc.)
- Each project get `solution/` and often `start/` or `your-work/` directories
- Images they keep for lesson-specific `images/` folders
- Translations dey `translations/{language-code}/` structure
## Build and Deployment
### Quiz App Deployment (Azure Static Web Apps)
Di quiz-app e configure for Azure Static Web Apps deployment:
Di quiz-app configure for Azure Static Web Apps deployment:
```bash
cd quiz-app
npm run build # Dey create dist/ folder
# Dey deploy with GitHub Actions workflow when you push to main
# E go deploy usin GitHub Actions workflow as you push for main branch
```
Azure Static Web Apps configuration:
@ -203,23 +203,23 @@ npm run convert # Make PDF from docs
### Docsify Documentation
```bash
npm install -g docsify-cli # Install Docsify everywhere for your system
docsify serve # Run am for localhost:3000
npm install -g docsify-cli # Install Docsify for everywhere
docsify serve # Make e dey serve for localhost:3000
```
### Project-specific Builds
Every project directory fit get im own build process:
- Vue projects: run `npm run build` to create production bundles
- Static projects: no build step, just serve files directly
Each project directory fit get him own build process:
- Vue projects: `npm run build` dey create production bundles
- Static projects: No build step, dem dey serve files direct
## Pull Request Guidelines
### Title Format
Use clear, descriptive titles wey show the area wey you change:
Use clear, descriptive titles wey talk the area wey you change:
- `[Quiz-app] Add new quiz for lesson X`
- `[Lesson-3] Fix typo in terrarium project`
- `[Lesson-3] Fix typo for terrarium project`
- `[Translation] Add Spanish translation for lesson 5`
- `[Docs] Update setup instructions`
@ -228,50 +228,50 @@ Use clear, descriptive titles wey show the area wey you change:
Before you submit PR:
1. **Code Quality**:
- Run `npm run lint` in affected project directories
- Run `npm run lint` for affected project directories
- Fix all linting errors and warnings
2. **Build Verification**:
- Run `npm run build` if e dey needed
- Run `npm run build` if e dey apply
- Make sure no build errors
3. **Link Validation**:
- Test all markdown links
- Verify image references dey work
- Confirm make image references dey work
4. **Content Review**:
- Check for spelling and grammar
- Make sure code examples dey correct and educational
- Verify translations dey keep original meaning
- Proofread for spelling and grammar
- Confirm code examples dey correct and educational
- Verify translations keep original meaning
### Contribution Requirements
- Agree to Microsoft CLA (automatic check for first PR)
- Agree to Microsoft CLA (automation go check am for first PR)
- Follow the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Check [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines
- Reference issue numbers inside PR description if e dey
- See [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed guidelines
- Reference issue numbers inside PR description if e relate
### Review Process
- PRs go dey reviewed by maintainers and community
- Educational clarity na priority
- Code examples suppose follow current best practices
- Translations go dey reviewed for accuracy and cultural fit
- Translations go dey checked for accuracy and cultural correctness
## Translation System
### Automated Translation
- Use GitHub Actions with co-op-translator workflow
- Translates to 50+ languages automatically
- E dey use GitHub Actions with co-op-translator workflow
- E translate to 50+ languages automatically
- Source files dey main directories
- Translated files dey inside `translations/{language-code}/` folders
- Translated files dey inside `translations/{language-code}/` directories
### Adding Manual Translation Improvements
1. Find file inside `translations/{language-code}/`
2. Make improvements but no disturb structure
3. Make sure code examples still dey work
1. Locate file inside `translations/{language-code}/`
2. Make improvements but keep structure intact
3. Confirm code examples still dey work well
4. Test any localized quiz content
### Translation Metadata
@ -294,76 +294,76 @@ CO_OP_TRANSLATOR_METADATA:
### Common Issues
**Quiz app no dey start**:
- Check Node.js version (v14+ recommended)
- Check Node.js version (v14+ na better)
- Delete `node_modules` and `package-lock.json`, run `npm install` again
- Check if port dey in use (Vite default dey port 5173)
- Check if port no dey busy (default: Vite dey use port 5173)
**API server no fit start**:
- Make sure Node.js version pass minimum (node >=10)
- Check if port already dey used
- Make sure all dependencies install finish with `npm install`
**API server no dey start**:
- Confirm Node.js version reach minimum (node >=10)
- Check if port don already dey use
- Confirm say all dependencies don install with `npm install`
**Browser extension no dey load**:
- Check manifest.json well make e correct
- Confirm manifest.json dey properly format
- Check browser console for errors
- Follow browser-specific extension installation instructions
**Python chat project wahala**:
- Make sure OpenAI package install: `pip install openai`
- Check say GITHUB_TOKEN environment variable dey set
- Check GitHub Models access permissions
- Confirm OpenAI package install: `pip install openai`
- Check GITHUB_TOKEN environment variable dey set
- Confirm GitHub Models get access permissions
**Docsify no dey serve docs**:
- Install docsify-cli globally: `npm install -g docsify-cli`
- Run am from repository root directory
- Check that `docs/_sidebar.md` dey there
- Check say `docs/_sidebar.md` dey there
### Development Environment Tips
- Use VS Code with Live Server extension for HTML projects
- Install ESLint and Prettier extensions for consistent formatting
- Use browser DevTools for debugging JavaScript
- Use VS Code plus Live Server extension for HTML projects
- Install ESLint and Prettier extensions to keep formatting consistent
- Use browser DevTools to debug JavaScript
- For Vue projects, install Vue DevTools browser extension
### Performance Considerations
- Plenty translated files (50+ languages) mean full clones dey big
- Use shallow clone if na only content you dey work on: `git clone --depth 1`
- Exclude translations from searches when you dey do English content
- Plenty translated files (50+ languages) mean full clones go big
- Use shallow clone if na only content you wan work on: `git clone --depth 1`
- Exclude translations from searches when you dey work on English content
- Build processes fit slow for first run (npm install, Vite build)
## Security Considerations
### Environment Variables
- API keys no suppose ever commit go repository
- Use `.env` files (dem dey already inside `.gitignore`)
- Document the environment variables wey project README dem require
- API keys no suppose ever commit to repository
- Use `.env` files (dem already inside `.gitignore`)
- Document environment variables wey project README need
### Python Projects
- Use virtual environments: `python -m venv venv`
- Keep dependencies up to date
- GitHub tokens suppose get only minimal needed permissions
- Keep dependencies updated
- GitHub tokens suppose get only minimal permissions
### GitHub Models Access
- Personal Access Tokens (PAT) dey required for GitHub Models
- Tokens suppose store as environment variables
- No ever commit tokens or credentials
- Personal Access Tokens (PAT) necessary for GitHub Models
- Tokens suppose dey stored as environment variables
- Never commit tokens or credentials
## Additional Notes
### Target Audience
- Complete beginners to web development
- Complete beginners for web development
- Students and self-learners
- Teachers wey dey use curriculum for classroom
- Content designed for accessibility and gradual skill building
- Teachers wey dey use curriculum for classrooms
- Content dey designed for accessibility and gradual skill building
### Educational Philosophy
- Project-based learning way
- Project-based learning approach
- Frequent knowledge checks (quizzes)
- Hands-on coding exercises
- Real-world application examples
@ -380,8 +380,8 @@ CO_OP_TRANSLATOR_METADATA:
- [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) wey people recommend for learners
- Other courses: Generative AI, Data Science, ML, IoT curricula dey available
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) wey dey recommended for learners
- Extra courses: Generative AI, Data Science, ML, IoT curricula dey available
### Working with Specific Projects
@ -394,15 +394,15 @@ For detailed instructions on individual projects, check README files inside:
### Monorepo Structure
Although dis no be traditional monorepo, dis repository get plenty independent projects:
- Every lesson dey self-contained
Although e no be traditional monorepo, dis repository get multiple independent projects:
- Each lesson na self-contained
- Projects no dey share dependencies
- You fit work on projects separately without affecting others
- Clone full repo if you want the complete curriculum experience
- You fit work on individual projects without disturbing others
- Clone whole repo for full curriculum experience
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Disclaimer**:
Dis document don translate by AI translation service [Co-op Translator](https://github.com/Azure/co-op-translator). Even though we dey try make am correct, abeg sabi say automated translations fit get mistakes or wrong parts. Di original document wey dey im correct language na im be di real correct source. For important matter, make you use professional human translation. We no go take any blame if person no understand well or interpret am wrong because of dis translation.
**Disclaimer**:
Dis document dem don translate am wit AI translation service wey dem dey call [Co-op Translator](https://github.com/Azure/co-op-translator). Even though we dey try make am correct, abeg make you sabi say automated translations fit get errors or no correct well. The original document wey dey the main language na im you suppose consider as the correct authority. If na important information you dey look for, e better make professional human translation do am. We no go responsible for any misunderstanding or wrong sense wey fit come from using this translation.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -1,7 +1,7 @@
{
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8",
"translation_date": "2026-03-06T15:24:09+00:00",
"original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-27T23:16:01+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "ta"
},
@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T15:38:26+00:00",
"translation_date": "2026-03-27T23:22:51+00:00",
"source_file": "AGENTS.md",
"language_code": "ta"
},

File diff suppressed because one or more lines are too long

@ -2,27 +2,27 @@
## Project Overview
ந்த அனுஷ்டானம் ஆரம்பகட்ட மாணவர்களுக்கு வலை வளர்ச்சி அடிப்படைகளை கற்பிப்பதற்கான கல்வி பாடத்திட்டக் களஞ்சியமாகும். இந்த பாடத்திட்டம் மைக்ரோசாஃப்ட் கிளௌட் வாதாளர்களால் உருவாக்கப்பட்ட முழுமையான 12 வார பாடநெறி ஆகும், இதில் ஜாவாஸ்கிரிப்ட், CSS, மற்றும் HTML-ஐ உள்ளடக்கிய 24 கையேடு பாடங்கள் உள்ளன.
து ஆரம்ப நிலைவர்களுக்கு வலை வளர்ச்சியின் அடிப்படைகளை கற்பிக்க பயன்படும் கல்விப் பாடத்திட்ட களஞ்சியம் ஆகும். இந்த பாடத்திட்டம் மைக்ரோசாஃப்ட் கிளவுட் ஆதரவாளர்களால் உருவாக்கப்பட்ட முழுமையான 12 வார பாடநெறி ஆகும், இதில் JavaScript, CSS மற்றும் HTML களை உள்ளடக்கிய 24 கைபுத்தக பாடங்கள் இருக்கும்.
### Key Components
- **கல்வி உள்ளடக்கம்**: 24 கட்டமைக்கப்பட்ட பாடங்கள், திட்ட அடிப்படையிலான மொட்யூல்கள்
- **பயன்முறை திட்டங்கள்**: டெரேரியம், டைப் செய்பவர் விளையாட்டு, உலாவி நீட்டிப்பு, விண்வெளி விளையாட்டு, வங்கி பயன்பாடு, குறியீடு ஆசிரியர், மற்றும் AI உரையாடல் உதவியாளர்
- **இணைய வினாடி கேள்விகள்**: 3 கேள்விகளுடன் 48 வினாக்கள் (முன்/பின் பாடநெறி மதிப்பீடுகள்)
- **பல மொழி ஆதரவு**: GitHub செயற்பாடுகள் மூலம் 50+ மொழிகளுக்கு தானியங்கி மொழிபெயர்ப்பு
- **கல்வி உள்ளடக்கம்**: திட்ட அடிப்படையிலான தொகுதிகளாக ஒழுங்குபடுத்தப்பட்ட 24 கட்டமைக்கப்பட்ட பாடங்கள்
- **பயிற்சி திட்டங்கள்**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, மற்றும் AI Chat Assistant
- **இணையாய்வு வினாக்கள்**: 48 வினாக்கள், ஒவ்வொன்றிலும் 3 கேள்விகள் (முன்/பின் பாட வினாக்கள்)
- **பலமொழி ஆதரவு**: GitHub Actions மூலம் 50+ மொழிகளுக்கான தானாக மொழிபெயர்ப்பு
- **தொழில்நுட்பங்கள்**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI திட்டங்களுக்கு)
### Architecture
- பாடத்தின் அடிப்படையிலான அமைப்பு கொண்ட கல்விக் களஞ்சியம்
- ஒவ்வொரு பாடத்துக்குமான கோப்புறை README, குறியீடு உதாரணங்கள் மற்றும் தீர்வுகளை கொண்டது
- தனித்தனியாய் உள்ள திட்டங்கள் (quiz-app, பல பாடத் திட்டங்கள்)
- GitHub செயற்பாடுகள் கொண்டு மொழிபெயர்ப்பு அமைப்பு (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
# பROWSER-சார்ந்த நீட்டித்தை ஏற்றுதல் வழிமுறைகளை பின்பற்றவும்
# உலாவி-சார்ந்த நீட்டிப்பு ஏற்றும் அறிவுறுத்தல்களை பின்பற்றவும்
```
### Space Game Projects
@ -64,7 +64,7 @@ npm install
```bash
cd 6-space-game/solution
npm install
# index.html ஐ உலாவியில் திறக்கவும் அல்லது லைவ் சர்வரை பயன்படுத்து
# 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. **மாற்றங்களுக்கான புதிய கிளை உருவாக்குக**
4. பாடத் தரவுகள் அல்லது குறியீடு உதாரணங்களில் மாற்றங்கள் செய்யவும
5. தொடர்புடைய திட்டக் கோப்புறைகளில் குறியீடுகளை சோதனை செய்யவும
6. பங்களிப்பு வழிகாட்டுதல்களை பின்பற்றி pull request சமர்ப்பிக்கவும
1. **களஞ்சியத்தை** உங்கள் GitHub கணக்கிற்கு பிளான் செய்யுங்கள்
2. **உங்கள் பிளானை** உள்ளூரில் கிளோன் செய்யுங்கள்
3. **உங்கள் மாற்றங்களுக்கு** புதிய கிளை உருவாக்குங்கள்
4. பாட உள்ளடக்கங்கள் அல்லது குறியீடு எடுத்துக்காட்டுகளில் மாற்றங்கள் செய்யுங்கள
5. தொடர்புடைய திட்ட அடைவுகளில் குறியீடு மாற்றங்களை சோதியுங்கள
6. பங்களிப்பு வழிகாட்டுதல்களை பின்பற்றி புல் கோரிக்கைகள் சமர்ப்பியுங்கள
### For Learners
1. களஞ்சியத்தை Fork செய்யவும் அல்லது Clone செய்யவும
2. பாடக் கோப்புறைகளில் தொடர் முறையில் செல்லவும
3. ஒவ்வொரு பாடத்திற்குமான README கோப்புகளை படிக்கவும
4. https://ff-quizzes.netlify.app/web/ என்ற இடத்தில் முன் பாட வினாடி கேள்விகளை முடிக்கவும்
5. பாடக் கோப்புறைகளில் குறியீடு உதாரணங்களைத் தொடர்ந்து வேலை செய்க
6. பணிகள் மற்றும் சவால்களை நிறைவேற்றுக
7. பின் பாட வினாடி கேள்விகளை எடுக்கவும்
1. களஞ்சியத்தை பிளான் செய்ய அல்லது கிளோன் செய்யுங்கள
2. பாட அடைவுகளுக்கு முறையே செல்லுங்கள
3. ஒவ்வொரு பாடத்திற்கும் README கோப்புகளை படியுங்கள
4. https://ff-quizzes.netlify.app/web/ இல் முன்-பாட வினாக்களை முடிக்கவும்
5. பாடக் கோப்பகங்களில் குறியீடு எடுத்துக்காட்டுகளைப் பயன்படுத்தி பணியாற்றவும்
6. கடமைகள் மற்றும் சவால்களை முடிக்கவும்
7. பிறகு பாட வினாக்களை எடுத்துக்கொள்ளவும்
### Live Development
- **ஆவணங்கள்**: ரூட் (port 3000)இல் `docsify serve` இயக்கவும்
- **Quiz App**: quiz-app கோப்புறையில் `npm run dev` இயக்கவும்
- **திட்டங்கள்**: VS Code Live Server நீட்டிப்பை HTML திட்டங்களுக்கு பயன்படுத்தவும்
- **API திட்டங்கள்**: சம்பந்தப்பட்ட API கோப்புறைகளில் `npm start` இயக்கவும்
- **ஆவணங்கள்**: முற்றிலும் கோப்பகத்தில் `docsify serve` ஐ இயக்கவும் (போர்ட் 3000)
- **வினா பயன்பாடு**: quiz-app கோப்பகத்தில் `npm run dev` நடைமுறைப்படுத்தவும்
- **திட்டங்கள்**: HTML திட்டங்களுக்கு VS Code Live Server நீட்சியைப் பயன்படுத்தவும்
- **API திட்டங்கள்**: சம்பந்தப்பட்ட API அடைவுகளில் `npm start` ஓட்டவும்
## Testing Instructions
@ -110,88 +110,88 @@ 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
- package.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 கூறுகள்
- பதிலளிக்கும் வடிவமைப்புக் கொள்கைகள்
- தெளிவான வகுப்பு பெயரிடுகைகள்
- CSS தொழில்நுட்பங்கள் விளக்கம் கருத்துக்களைச் சேர்க்கவும
- பதிலளிக்கும் வடிவமைப்பு கோட்பாட்டுக்கள்
- தெளிவான வகுப்பு பெயர்ப்பாணிகள்
- CSS தொழில்நுட்பங்களுககு ஒரு விளக்கம் வகையில் கருத்துக்கள்
### Python
- PEP 8 பாணி வழிகாட்டுதல்கள்
- தெளிவான, கல்வி குறியீடு உதாரணங்கள்
- கற்றுக்கொள்ள உதவும் இடங்களில் வகை குறிப்பு
- PEP 8 நடைமுறைகள்
- தெளிவான, கல்வி குறியீடு எடுத்துக்காட்டுகள்
- கற்றலுக்கு உதவிகள் போல வகை குறிப்புகள்
### Markdown Documentation
- தெளிவான தலைப்பு வரிசைமை
- மொழி குறிப்ப் குறியீடு தொகுதிகள்
- தெளிவான தலைப்பு வரிசை
- மொழி விவரிக்கப்பட் குறியீடு தொகுதிகள்
- கூடுதல் வளங்களுக்கு இணைப்புகள்
- `images/` கோப்புறைகளில் திரைபடங்கள் மற்றும் படங்கள்
- படங்களுக்கு அணுகல் வசதிக்கான Alt உரை
- `images/` கோப்பகங்களில் ஸ்க்ரீன் ஷாட்கள் மற்றும் படங்கள்
- படங்களுக்கு மாற்று உரை அணுகலை மேம்படுத்த
### 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/ கோப்பகத்தை உருவாக்குகிறது
# main க்கு push செய்ததும் GitHub Actions workflow மூலம் அப்லோடுசெய்கிறது
```
Azure Static Web Apps அமைப்பு:
- **App இடம்**: `/quiz-app`
- **வெளியீடு இடம்**: `dist`
- **வேலைபாடு**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
Azure Static Web Apps அமைப்புகள்:
- **அப் இருப்பிடம்**: `/quiz-app`
- **வெளியீட்டு இடம்**: `dist`
- **நடவடிக்கை வரிசை**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Documentation PDF Generation
@ -203,76 +203,76 @@ 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` மூலம் தயாரிப்பு தொகுதிகள் உருவாகும்
- நிலையான (static) திட்டங்கள்: கட்டுமான படி இல்லை, கோப்புகளை நேரடியாக வழங்குகிறது
ஒவ்வொரு திட்டத்திற்கும் தனிப்பட்ட கட்டுமான செயல்முறை இருக்கலாம்:
- Vue திட்டங்கள்: `npm run build` மூலம் தயாரிப்பு தொகுதிகள் உருவாகிறத
- நிலையான (static) திட்டங்கள்: கட்டுமான படி இல்லை, கோப்புகள் நேரடியாக வழங்கப்படுகின்றன
## Pull Request Guidelines
### Title Format
மாற்றத்தை தெளிவாக விளக்கும் தலைப்புகளைப் பயன்படுத்துக:
- `[Quiz-app] பாடம் X க்கான புதிய வினாடி கேள்வி சேர்க்கவும்`
- `[Lesson-3] டெரேரியம் திட்டத்தில் எழுத்துப் பிழை திருத்தவும்`
- `[Translation] பாடம் 5 க்கு ஸ்பானிஷ் மொழிபெயர்ப்பு சேர்க்கவும்`
- `[Docs] அமைப்பு வழிமுறைகளை புதுப்பிக்கவும்`
மாற்றம் செய்யப்பட்ட பகுதி தெளிவாகக் காட்டும் தலைப்புகளைப் பயன்படுத்தவும்:
- `[Quiz-app] Lesson X க்கான புதிய வினா சேர்க்கவும்`
- `[Lesson-3] Terrarium திட்டத்தில் எழுத்துப்பிழை சரி செய்க`
- `[Translation] பாடம் 5க்கான ஸ்பானிஷ் மொழிபெயர்ப்பு சேர்க்கவும்`
- `[Docs] அமைப்பு அறிவுறுத்தலை புதுப்பிக்கவும்`
### Required Checks
PR சமர்ப்பிப்பதற்கு முன்:
1. **குறியீடு தரம்**:
- சம்பந்தப்பட்ட திட்டக் கோப்புறைகளில் `npm run lint` இயக்கவும்
- அனைத்து lint பிழைகள் மற்றும் எச்சரிக்கைகளை சரி செய்யவும்
- பாதிக்கப்பட்ட திட்ட அடைவுகளில் `npm run lint` இயக்கவும்
- அனைத்து பிழைகூறுகளையும் சரி செய்யவும்
2. **கட்டுமான சரிபார்ப்பு**:
- பொருந்துமானால் `npm run build` இயக்கவும்
- கட்டுமான பிழைகள் வராமல் உறுதி செய்யவும்
- கட்டுமான பிழைகள் இல்லை என்பதைக் உறுதிசெய்க
3. **இணைய இணைப்பு சரிபார்ப்பு**:
- அனைத்து மார்க்டவுன் லிங்குகளை சோதிக்கவும்
- படம் மேற்கோள்கள் வேலை செய்கின்றதா என உறுதிசெய்யவும்
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 Code of Conduct](https://opensource.microsoft.com/codeofconduct/) பின்பற்றவும்
- விரிவான வழிகாட்டல்களுக்கு [CONTRIBUTING.md](./CONTRIBUTING.md) பார்க்கவும்
- பொருந்துமானால் PR விவரத்தில் பிரச்சினை எண்களை குறிப்பிடவும
### Review Process
- PR-களை பராமரிப்பவர்கள் மற்றும் சமுதாயம் விமர்சனப்படுத்துவர
- கல்வி தெளிவு முன்னிருத்தப்படும்
- குறியீடு உதாரணங்கள் தற்போதைய சிறந்த நடைமுறைகளை பின்பற்றவேண்டும்
- மொழிபெயர்ப்புகள் துல்லியமும் பண்பாட்டுத் தகுதியும் பரிசீலிக்கப்படும்
- PRகள் பராமரிப்பவர்களால் மற்றும் சமுதாயத்தால் பரிசீலிக்கப்படும
- கல்வி தெளிவு முக்கியமாக கருதப்படும்
- குறியீடு எடுத்துக்காட்டுகள் தற்போதைய சிறந்த நடைமுறைகளை பின்பற்ற வேண்டும்
- மொழிபெயர்ப்புகள் துல்லியமாகவும் பண்பாட்டு பொருத்தமாகவும் இருக்கும்
## Translation System
### Automated Translation
- GitHub செயற்பாடுகள் மற்றும் co-op-translator வேலைப்பாட்டைப் பயன்படுத்துகிறது
- தானாக 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
@ -293,116 +293,116 @@ CO_OP_TRANSLATOR_METADATA:
### Common Issues
**Quiz app துவங்காமல் போவது**:
- Node.js பதிப்பchecks (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 உரையாடல் திட்ட பிழைகள்**:
- OpenAI தொகுதி நிறுவப்பட்டுள்ளதா (`pip install openai`)
- GITHUB_TOKEN சுற்றுச்சூழல் மாறி அமைக்கப்பட்டுள்ளது
- GitHub Models அணுகல் அனுமதிகளை சரிபார்க்கவும்
**Python அரட்டை திட்ட பிழைகள்**:
- OpenAI தொகுப்பை நிறுவி உள்ளதா: `pip install openai`
- GITHUB_TOKEN சுற்றுப்புற மாறி அமைந்திருகிறதா பாருங்கள்
- GitHub மாதிரிகள் அணுகல் அங்கீகாரம் சரிபார்க்கவும்
**Docsify ஆவணங்கள் வழங்கவில்லை**:
- docsify-cli-ஐ உலகளவில் நிறுவவும்: `npm install -g docsify-cli`
- களஞ்சியத்தின் ரூட் கோப்புறைஇருந்து இயக்கவும்
- `docs/_sidebar.md` உள்ளது என உறுதிசெய்க
**Docsify ஆவண சேவை இல்லை**:
- 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 நீட்சிகளை நிறுவவும்
- ஜாவாஸ்கிரிப்ட் பிழையினை கண்டறிய உலாவி DevTools ஐ பயன்படுத்தவும்
- Vue திட்டங்களுக்கு Vue DevTools உலாவி நீட்சியை நிறுவவும்
### Performance Considerations
- 50+ மொழிகளில் மொழிபெயர்க்கப்பட்ட கோப்புகள் அதிகம் இருப்பதால் முழு கிளோன் பெரிதாக இருக்கும்
- உள்ளடக்கம் மட்டுமே வேலை செய்வின் `git clone --depth 1` பயன்படுத்தவும்
- ஆங்கில உள்ளடக்கத்தில் மொழிபெயர்ப்புகளைத் தேடும் போது தவிர்க்கவும்
- கட்டுமான செயல்முறைகள் முதன்முறையாக மெதுவாக இருக்கலாம் (npm install, Vite build)
- மொழிபெயர்க்கப்பட்ட கோப்புகளின் அதிக எண்ணிக்கை (50+ மொழிகள்) முழு கிளோன்களை பெரிதாக்குகிறது
- உள்ளடக்கத்தில் மட்டும் பணியாற்ற shallow clone ஐப் பயன்படுத்தவும்: `git clone --depth 1`
- ஆங்கில உள்ளடக்கத்திற்கான தேடல்களில் மொழிபெயர்ப்புகளை தவிர்க்கவும்
- முதல் ஓட்டத்தில் (npm install, Vite build) கட்டுமான செயல்முறை மெதுவாக இருக்கலாம்
## Security Considerations
### Environment Variables
- API விசைகள் களஞ்சியத்தில் சேர்க்கப்படக் கூடாது
- `.env` கோப்புகளை பயன்படுத்தவும் (ஈவ்வுலகில் `.gitignore` உள்ளது)
- திட்ட README-களில் தேவைப்படும் சுற்று மாறிகள் ஆவணப்படுத்தவும்
- API விசைகளை களஞ்சியத்தில் விடாது
- `.env` கோப்புகளை பயன்படுத்தவும் (இவை `.gitignore` இல் உள்ளன)
- தேவையான சுற்றுப்புற மாறிகளை திட்ட README கோப்புகளில் ஆவணப்படுத்தவும்
### Python Projects
- மெய்நிகர் சுற்றுச்சூழல்களை பயன்படுத்தவும்: `python -m venv venv`
- சார்புகளை புதுப்பித்து வைக்கவும்
- GitHub டோக்கன்களுக்கு குறைந்தபட்ச தேவையான அனுமதிகளை அளிக்கவும்
- வேர்ச்சுவல் சுற்றுப்புறங்களை பயன்படுத்தவும்: `python -m venv venv`
- சார்புகள் புதுப்பிக்கப்படுகின்றன என்பதை உறுதிசெய்க
- GitHub டோக்கன்கள் குறைந்தபட்ச தேவைகளுடன் இருக்க வேண்டும்
### GitHub Models Access
- GitHub Models-க்கு தனிப்பட்ட அணுகல் டோக்கன்கள் தேவை
- டோக்கன்களை சுற்றுச்சூழல் மாறிகளாக வைத்திருக்கவும்
- டோக்கன் அல்லது சான்றுகளை களஞ்சியத்தில் சேர்க்கக்கூடாது
- GitHub மாதிரிகளுக்கு தனிப்பட்ட அணுகல் டோக்கன்கள் (PAT) தேவை
- டோக்கன்கள் சுற்றுப்புற மாறிகளாக வாங்கப்பட வேண்டும்
- டோக்கன்கள் அல்லது அங்கீகாரங்கள் ஒருபோதும் களஞ்சியத்தில் சேர்க்கப்படக்கூடாது
## Additional Notes
### Target Audience
- முழுமையாக ஆரம்ப நிலையில் உள்ள வலை வளர்ச்சி கற்றுக் கொள்ளும்வர
- மாணவர்கள் மற்றும் சுய கற்றுநர
- வகுப்பறைகளில் பாடத்திட்டத்தை பயன்படுத்தும் ஆசிரியர்கள்
- அணுகல் வசதிக்கானவும் படிப்படியாக திறமை வளர்க்கும் வகையിലുള്ള உள்ளடக்கம்
- வலை வளர்ச்சியில் முழுமையாக புதியவர்கள
- மாணவர்கள் மற்றும் சுய கற்றல் செய்பவர்கள
- வகுப்பறைில் பாடத்திட்டத்தைப் பயன்படுத்தும் ஆசிரியர்கள்
- உள்ளடக்கம் அணுகல் சாதகத்துக்கும் மெதுவாக திறன்களை வளர்க்கவும் வடிவமைக்கப்பட்டுள்ளது
### Educational Philosophy
- திட்ட அடிப்படையிலான கற்றல் முறை
- அடிக்கடி அறிவு சோதனை (வினாடி ேளவிகள்)
- கையேடு குறியீடு பயிற்சிகள்
- நெறிமுறை பயன்பாட்டு உதாரணங்கள்
- கட்டமைப்புகளை விட அடிப்படைகளை முன்னுரிமை
- திட்ட அடிப்படையிலான கற்றல் முறைகள்
- அடிக்கடி அறிவு பரிசோதனைகள் (வினாக்கள்)
- கைபுத்தக குறியீடு பயிற்சிகள்
- உலகத் தளத்தில் பயன்பாடுகள் எடுத்துக்காட்டுகள்
- கட்டமைப்புகளுக்கு முன்பாக அடிப்படைகளை கவனித்தல்
### Repository Maintenance
- திடீர் மாணவர்கள் மற்றும் பங்களிப்பாளர்கள் மூலம் செயலில
- சார்புகள் மற்றும் உள்ளடக்கங்களில் தேவையான புதுப்பிப்புகள்
- பிரச்சினைகள் மற்றும் விவாதங்கள் பராமரிப்போரால் கண்காணிப்பு
- மொழிபெயர்ப்பு புதுப்பிப்புகள் GitHub செயல்பாடுகள் மூலம் தானாக நடைபெறுகின்றன
- பயில்வோர் மற்றும் பங்களிப்பாளர்களின் செயற்பாட்டுத் சமூகம
- சார்புகள் மற்றும் உள்ளடக்கங்களுக்கான திட்டமான புதுப்பிப்புகள்
- பராமரிப்பாளர்களால் பிரச்சனைகள் மற்றும் விவாதங்கள் கண்காணிப்பு
- 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) கற்றலுக்கான பரிந்துரை
- கூடுதல் பாடநெறிகள்: பிறந்த AI, தரவு அறிவியல், இயந்திர கற்றல், IoT பாடத்திட்டங்கள்
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) மாணவர்களுக்கு பரிந்துரைக்கப்படுகிறது
- கூடுதல் பாடநெறிகள்: Generative AI, Data Science, ML, IoT பாடத்திட்டங்கள் கிடைக்கின்றன
### Working with Specific Projects
ஒவ்வொரு திட்டத்திற்கான விரிவான வழிமுறைகள் 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 உரையாடல் உதவியாளர் திட்டம்
தனிநபர் திட்டங்களுக்கு விரிவான அறிவுறுத்தல்களுக்கு 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 அரட்டை உதவியாளர் திட்டம்
### Monorepo Structure
சார்பு பகிர்வு இல்லாத பல தனித்தனியான திட்டங்கள் கொண்ட களஞ்சியம்:
- ஒவ்வொரு பாடமும் தனித்தனியாக உள்ளது
- திட்டங்கள் சார்புகளை பகிரில்லை
- தனித்திட்டங்களில் வேலை செய்யலாம் மற்றவற்றை பாதிக்காமல
- முழு பாடத்திட்ட அனுபவத்திற்கான முழுக் களஞ்சியத்தை கிளோன் செய்யவும்
சாதாரண மொனோரெப்போ அல்ல, ஆனால் இதில் பல தனித்தனி திட்டங்கள் உள்ளன:
- ஒவ்வொரு பாடமும் தனிபட்டது
- திட்டங்கள் சார்புகளை பகிரவில்லை
- தனி திட்டங்களில் வேறு திட்டங்களை பாதிக்காமல் பணியாற்றலாம
- முழு பாடத்திட்ட அனுபவத்திற்கு முழு களஞ்சியத்தை கிளோன் செய்யவும்
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**புரிந்துணர்வு**:
இந்த ஆவணம் [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