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

pull/1690/head
localizeflow[bot] 3 weeks ago
parent 8f077f4be7
commit dfe67054a3

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T12:11:30+00:00",
"translation_date": "2026-02-06T13:33:20+00:00",
"source_file": "AGENTS.md",
"language_code": "et"
},

@ -2,42 +2,42 @@
## Projekti ülevaade
See on hariduslik õppekava hoidla veebiarenduse fundamentide õpetamiseks algajatele. Õppekava on põhjalik 12-nädalane kursus, mille on koostanud Microsoft Cloud Advocates, sisaldades 24 praktilist õppetundi, mis käsitlevad JavaScripti, CSS-i ja HTML-i.
See on hariduslik õppekava hoidla veebiarenduse aluste õpetamiseks algajatele. Õppekava on Microsoft Cloud Advocatesi välja töötatud põhjalik 12-nädalane kursus, mis sisaldab 24 praktilist õppetundi, hõlmates JavaScripti, CSSi ja HTMLi.
### Peamised komponendid
### Põhikomponendid
- **Hariduslik sisu**: 24 struktureeritud õppetundi, mis on korraldatud projektipõhistesse moodulitesse
- **Praktilised projektid**: Terrarium, Tippimismäng, Brauserilaiendus, Kosmosemäng, Pangaäpp, Koodi redaktor ja AI juturobot
- **Interaktiivsed viktoriinid**: 48 viktoriini, igas 3 küsimust (enne/pärast tundi hindamine)
- **Mitmekeelne tugi**: Automaatne tõlkimine enam kui 50 keelde GitHub Actions abil
- **Hariduslik sisu**: 24 struktureeritud õppetundi, korraldatud projektipõhistesse moodulitesse
- **Praktilised projektid**: Terrarium, Tippimismäng, Brauserilaiend, Kosmosemäng, Panga rakendus, Koodiredaktor ja tehisintellekti juturobot
- **Interaktiivsed viktoriinid**: 48 viktoriini, igas 3 küsimust (enne ja pärast õppetundi)
- **Mitmekeelne tugi**: Automaatne tõlkimine 50+ keelde 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
- Igas õppetundi kaustas on README, koodinäited ja lahendused
- Isetegutsevad projektid eraldi kaustades (quiz-app, erinevad õppetundide projektid)
- Tõlkesüsteem kasutades GitHub Actions (co-op-translator)
- Dokumentatsioon serveeritakse Docsify abil ja on saadaval PDF-ina
- Hariduslik hoidla, millel on õppetundide põhine struktuur
- Igas õppetunni kaustas on README, koodinäited ja lahendused
- Iseseisvad projektid eraldi kaustades (quiz-app, erinevad õppetundide projektid)
- Tõlketeenus kasutades GitHub Actions (co-op-translator)
- Dokumentatsioon esitatakse Docsifyga ja on saadaval PDF-formaadis
## Paigaldus käsud
## Käivitus käsud
See hoidla on peamiselt mõeldud haridusliku sisu tarbimiseks. Spetsiifiliste projektidega töötamiseks:
### Peamise hoidla seadistamine
### Peahoidla seadistamine
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### Viktoriini äpi seadistamine (Vue 3 + Vite)
### Viktoriinirakenduse seadistamine (Vue 3 + Vite)
```bash
cd quiz-app
npm install
npm run dev # Käivita arendusserver
npm run build # Loo tootmiseks
npm run build # Koosta tootmiseks
npm run lint # Käivita ESLint
```
@ -48,15 +48,15 @@ cd 7-bank-project/api
npm install
npm start # Käivita API server
npm run lint # Käivita ESLint
npm run format # Vorminda Prettieriga
npm run format # Vorminda Prettier'iga
```
### Brauserilaienduse projektid
### Brauserilaiendi projektid
```bash
cd 5-browser-extension/solution
npm install
# Järgige brauserispetsiifilisi laienduste laadimise juhiseid
# Järgige brauseripõhiseid laienduste laadimise juhiseid
```
### Kosmosemängu projektid
@ -67,7 +67,7 @@ npm install
# Ava index.html brauseris või kasuta Live Serverit
```
### Jutu projekti (Python Backend)
### Jutuprojekti (Python taust)
```bash
cd 9-chat-project/solution/backend/python
@ -78,35 +78,35 @@ python api.py
## Arendusvoog
### Sisukontribuutoritele
### Sisu panustajatele
1. **Forki hoidla** oma GitHub kontole
2. **Klooni oma fork** lokaalselt
1. **Tee hoidlast fork** oma GitHubi kontole
2. **Klooni oma fork lokaalselt**
3. **Loo uus haru** oma muudatuste jaoks
4. Tee muudatusi õppetundide sisus või koodinäidetes
5. Testi koodimuudatusi asjakohastes projektikaustades
6. Esita pull requesteid vastavalt panustamise juhistele
5. Testi koodimuudatusi vastavates projektikaustades
6. Esita pull requestid vastavalt panustamise juhistele
### Õppijatele
1. Forki või klooni hoidla
2. Liigu õppetundide kaustades järjekorras
3. Loe iga tunni README faile
4. Tee enne tundi viktoriinid aadressil https://ff-quizzes.netlify.app/web/
5. Pronksivõõra koodinäited õppetundide kaustades
6. Tee ülesanded ja väljakutsed
7. Võta pärast tundi viktoriinid
1. Tee fork või klooni hoidla
2. Liigu õppetundide kaustades järjestikku
3. Loe iga õppetunni README faile
4. Täida enne õppetundi viktoriinid aadressil https://ff-quizzes.netlify.app/web/
5. Tööta läbi koodinäited õppetundide kaustades
6. Täida ülesandeid ja väljakutseid
7. Tee pärast õppetundi viktoriinid
### Otsene arendus
### Otse arendus
- **Dokumentatsioon**: käivita juurkaustas `docsify serve` (port 3000)
- **Viktoriini äpp**: käivita `npm run dev` quiz-app kaustas
- **Projektid**: kasuta VS Code Live Serveri laiendust HTML projektide jaoks
- **Dokumentatsioon**: käivita `docsify serve` juurkaustas (port 3000)
- **Viktoriinirakendus**: käivita `npm run dev` quiz-app kaustas
- **Projektid**: kasuta VS Code Live Serveri lisandit HTML projektide jaoks
- **API projektid**: käivita `npm start` vastavates API kaustades
## Testimise juhised
### Viktoriini äpi testimine
### Viktoriinirakenduse testimine
```bash
cd quiz-app
@ -118,165 +118,165 @@ 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äivitub ilma vigadeta
npm run lint # Kontrolli koodi stiili probleeme
node server.js # Kontrolli, kas server käivitub ilma vigadeta
```
### Üldine testimise lähenemine
### Üldine testimisstrateegia
- See on hariduslik hoidla ilma täielike automatiseeritud testideta
- See on hariduslik hoidla, millel puuduvad põhjalikud automaattestid
- Käsitsi testimine keskendub:
- Koodinäidete käivitumine vigadeta
- Dokumentatsiooni linkide toimimine
- Projektide edukas ehitamine
- Näidete vastavus parimatele tavadele
- Koodinäited käivituvad ilma vigadeta
- Dokumentatsiooni lingid töötavad korrektselt
- Projektide ehitused õnnestuvad
- Näited järgivad parimaid praktikaid
### Enne esitamist tehtavad kontrollid
### Enne esitust tehtavad kontrollid
- Käivita `npm run lint` kaustades, kus on package.json
- Kontrolli markdown linkide kehtivust
- Kontrolli, et markdown lingid oleksid kehtivad
- Testi koodinäiteid brauseris või Node.js-is
- Veendu, et tõlked säilitavad õige struktuuri
- Kontrolli, et tõlked säilitavad korrektse struktuuri
## Koodistiili juhised
## Koodi stiili juhised
### JavaScript
- Kasuta kaasaegset ES6+ süntaksit
- Järgi ESLinti standardseid konfigureeringuid projektides
- Järgi projektides antud standardseid ESLinti konfigureeringuid
- Kasuta tähenduslikke muutujate ja funktsioonide nimesid hariduse selguse huvides
- Lisa kommentaare kontseptsioonide selgitamiseks õppijatele
- Formatteeri Prettieriga, kus seadistatud
- Lisa kommentaarid õppematerjali selgitamiseks
- Vorminda Prettieriga, kus see on seadistatud
### HTML/CSS
- Semantiline HTML5 elementide kasutamine
- Responsive disaini põhimõtted
- Semantiline HTML5 elementide kasutus
- Paindlikud kujunduspõhimõtted
- Selged klassinimed
- Kommentaarid CSS tehnikate selgitamiseks õppijatele
### Python
- PEP 8 stiili juhised
- PEP 8 stiilijuhised
- Selged, hariduslikud koodinäited
- Tüübi vihjed, kui need aitavad õppimist
- Tüübimärgised, kus õppimise huvides abiks
### Markdown dokumentatsioon
- Selge pealkirjade hierarhia
- Koodiplokid keelespetsiifikatsiooniga
- Koodiplokid koos keelespetsifikatsiooniga
- Lingid lisamaterjalidele
- Ekraanipildid ja pildid `images/` kaustades
- Piltide alternatiivtekst juurdepääsetavuse jaoks
- Ekraanitõmmised ja pildid `images/` kaustades
- Pildidel alternatiivtekst ligipääsetavuse jaoks
### Failide organiseerimine
### Faili organiseerimine
- Õppetunnid nummerdatud järjestikustena (1-getting-started-lessons, 2-js-basics jne)
- Õppetunnid nummerdatud järjestikku (1-getting-started-lessons, 2-js-basics jne)
- Igal projektil on `solution/` ja sageli `start/` või `your-work/` kaustad
- Pildid salvestatud õppetundipõhistesse `images/` kaustadesse
- Tõlked struktuuris `translations/{language-code}/`
- Pildid hoitakse õppetundipõhistes `images/` kaustades
- Tõlked kaustas `translations/{language-code}/`
## Ehitamine ja juurutamine
### Viktoriini äpi juurutamine (Azure Static Web Apps)
### Viktoriinirakenduse juurutamine (Azure Static Web Apps)
quiz-app on seadistatud Azure Static Web Apps juurutuseks:
Quiz-app on seadistatud Azure Static Web Appsi juurutuseks:
```bash
cd quiz-app
npm run build # Loob dist/ kausta
# Hõlbustab juurutamist GitHub Actions töövoo kaudu, kui tehakse push main harule
# Juurutab GitHub Actions töövoo kaudu, kui tehakse push main harusse
```
Azure Static Web Apps konfiguratsioon:
- **Rakenduse asukoht**: `/quiz-app`
- **Väljundi asukoht**: `dist`
- **Väljundkaust**: `dist`
- **Töövoog**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Dokumentatsiooni PDF genereerimine
### Dokumentatsiooni PDF loomine
```bash
npm install # Paigalda docsify-to-pdf
npm run convert # Genereeri PDF docsist
npm run convert # Loo PDF docsist
```
### Docsify dokumentatsioon
```bash
npm install -g docsify-cli # Installi Docsify globaalalt
docsify serve # Serveri aadressil localhost:3000
npm install -g docsify-cli # Paigalda Docsify globaalselt
docsify serve # Serveeri aadressil localhost:3000
```
### Projekti-spetsiifilised ehitused
Igal projektikaustal võib olla oma ehitusprotsess:
- Vue projektid: `npm run build` loob tootmispaketid
- Staatilised projektid: ehitusetapp puudub, serveeri faile otse
Igal projekti kaustal võib olla oma ehitusprotsess:
- Vue projektid: `npm run build` loob tootmispakkumised
- Staatilised projektid: puudub ehitusaste, failid serveeritakse otse
## Pull requesti juhised
### Pealkirja formaat
### Pealkirja vorming
Kasuta selgeid ja kirjeldavaid pealkirju, mis näitavad muudatuste valdkonda:
- `[Quiz-app] Lisa uus viktoriin õppetunni X jaoks`
- `[Lesson-3] Paranda trükk vigu terrarium projektis`
- `[Translation] Lisa hispaania keelne tõlge õppetunnile 5`
- `[Docs] Uuenda seadistusjuhiseid`
Kasuta selgeid, kirjeldavaid pealkirju, mis näitavad muutuse valdkonda:
- `[Quiz-app] Lisa uus viktoriin õppetunnile X`
- `[Õppetund-3] Paranda trükiviga terrarium projektis`
- `[Tõlge] Lisa hispaania tõlge õppetunnile 5`
- `[Dokumentatsioon] Uuenda seadistuse juhiseid`
### Nõutavad kontrollid
Enne PR-i esitamist:
Enne PR esitamist:
1. **Koodi kvaliteet**:
- Käivita `npm run lint` mõjutatud projektikaustades
- Paranda kõik lintimise vead ja hoiatused
- Paranda kõik lint vead ja hoiatused
2. **Ehituse kontrollimine**:
- Käivita vajadusel `npm run build`
- Veendu, et ehitusvigu pole
2. **Ehituse kontroll**:
- Kui sobib, tee `npm run build`
- Veendu, et ehitus ei anna vigu
3. **Linkide valideerimine**:
3. **Linkide kontroll**:
- Testi kõiki markdown linke
- Kontrolli pildiviiteid
- Kontrolli, et pildi viited toimivad
4. **Sisu läbivaatus**:
- Luge ja paranda kirjavead ja grammatika
4. **Sisu ülevaatus**:
- Typosid ja grammatikat kontrolli
- Veendu, et koodinäited on korrektsed ja hariduslikud
- Kontrolli, et tõlked säilitavad algse tähenduse
- Kontrolli, et tõlked säilitavad originaalse tähenduse
### Panustamise nõuded
### Panustamise tingimused
- Nõustu Microsofti CLA-ga (automaatkontroll esimese PR-i ajal)
- Järgi [Microsoft Open Source käitumiskoodeksit](https://opensource.microsoft.com/codeofconduct/)
- Vaata üksikasjalikke juhiseid [CONTRIBUTING.md](./CONTRIBUTING.md) failist
- Viita PR kirjelduse juures vajadusel probleemide numbritele
- Nõustu Microsoft CLA-ga (automaattest esimese PR ajal)
- Järgi [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Vaata üksikasjalikke juhiseid failist [CONTRIBUTING.md](./CONTRIBUTING.md)
- Viita asjakohastele issue numbritele PR kirjelduse juures
### Ülevaatusprotsess
- PR-e üle vaatavad hooldajad ja kogukond
- PR-e vaatavad üle hooldajad ja kogukond
- Eelistatakse hariduslikku selgust
- Koodinäited peaksid järgima hetke parimaid tavasid
- Tõlked vaadatakse läbi täpsuse ja kultuurilise sobivuse huvides
- Koodinäited peaksid järgima parimaid praktikaid
- Tõlked kontrollitakse täpsuse ja kultuurilise sobivuse osas
## Tõlkesüsteem
## Tõlketeenus
### Automaatne tõlkimine
- Kasutab GitHub Actions koos co-op-translator töövooga
- Tõlgib automaatselt enam kui 50 keelde
- Allikafailid peamistes kaustades
- Tõlgitud failid kaustades `translations/{language-code}/`
- Tõlgib automaatselt 50+ keelde
- Allikfailid põhikaustades
- Tõlgitud failid `translations/{language-code}/` kaustades
### Käsitsi tõlkeparanduste lisamine
1. Otsi fail kaustast `translations/{language-code}/`
1. Leia fail `translations/{language-code}/`
2. Tee parandused, säilitades struktuuri
3. Veendu, et koodinäited toimivad edasi
4. Testi lokaliseeritud viktoriinisisu
3. Veendu, et koodinäited säilivad töökorras
4. Testi lokaalset viktoriini sisu
### Tõlkemetaandmed
### Tõlke metaandmed
Tõlgitud failidel on metadata päis:
Tõlgitud failidel on metaandmete päis:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -293,103 +293,103 @@ CO_OP_TRANSLATOR_METADATA:
### Levinumad probleemid
**Viktoriini äpp ei käivitu**:
- Kontrolli Node.js versiooni (v14+ soovitatav)
- Kustuta `node_modules` ja `package-lock.json`, käivita `npm install` uuesti
- Kontrolli pordi konflikte (vaikimisi: Vite kasutab porti 5173)
**Viktoriinirakendus ei käivitu**:
- Kontrolli Node.js versiooni (soovitatav v14+)
- Kustuta `node_modules` ja `package-lock.json`, käivita uuesti `npm install`
- Kontrolli pordikonflikte (vaikimisi: Vite kasutab porti 5173)
**API server ei käivitu**:
- Veendu, et Node.js versioon vastab minimaalsetele nõuetele (node >=10)
- Kontrolli, kas port on juba kasutuses
- Kontrolli, et kõik sõltuvused on installitud käsklusega `npm install`
- Veendu, et Node.js versioon on piisav (node >=10)
- Kontrolli, kas port on juba hõivatud
- Veendu, et kõik sõltuvused on paigaldatud käsuga `npm install`
**Brauserilaiendus ei laadi**:
- Kontrolli, et manifest.json on korrektselt vormindatud
- Vaata brauseri konsoolist vigu
- Järgi brauserispetsiifilisi laiendi paigaldamise juhiseid
**Brauserilaiendi laadimine ebaõnnestub**:
- Kontrolli, et manifest.json on õigesti vormindatud
- Vaata brauseri konsoolivigu
- Järgi konkreetse brauseri laiendi paigaldusjuhiseid
**Python jutuprojekti probleemid**:
- Veendu, et OpenAI pakett on installitud: `pip install openai`
- Kontrolli, et GITHUB_TOKEN keskkonnamuutuja on seadistatud
- Kontrolli GitHub Models ligipääsu õiguseid
- Veendu, et OpenAI pakett on paigaldatud: `pip install openai`
- Kontrolli, et GITHUB_TOKEN keskkonnamuutuja on määratud
- Kontrolli GitHubi mudelite ligipääsuõigusi
**Docsify ei serveeri dokumente**:
- Paigalda globaalne docsify-cli: `npm install -g docsify-cli`
- Paigalda docsify-cli globaalne tööriist: `npm install -g docsify-cli`
- Käivita hoidla juurkataloogist
- Kontrolli, et `docs/_sidebar.md` olemas
- Veendu, et fail `docs/_sidebar.md` olemas on
### Arenduskeskkonna nõuanded
### Arenduskeskkonna näpunäited
- Kasuta VS Code Live Server laiendust HTML projektidel
- Paigalda ESLint ja Prettier laiendid järjepidevaks vormindamiseks
- Kasuta brauseri DevTools JavaScripti silumiseks
- Vue projektide jaoks paigalda Vue DevTools brauserilaiendus
- Kasuta VS Code'i koos Live Server lisandiga HTML projektide jaoks
- Paigalda ESLint ja Prettier laiendid ühtlase vorminduse jaoks
- Kasuta brauseri arendustööriistu JavaScripti silumiseks
- Vue projektide jaoks paigalda Vue DevTools brauserilaiend
### Jõudlusküsimused
### Jõudluskaalutlused
- Rohkem kui 50 keeles tõlgitud failide arv tähendab, et täielikud kloonid on suured
- Kasuta pindmist klooni, kui töötab ainult sisuga: `git clone --depth 1`
- Väldi tõlgete otsingut ingliskeelse sisu töötamisel
- Ehitamine võib esmakordselt olla aeglane (npm install, Vite ehitus)
- Suur hulk tõlgitud faile (50+ keelt) muudab terviklikud kloonid mahukaks
- Kasuta madala sügavusega klooni, kui töötad ainult sisuga: `git clone --depth 1`
- Väldi tõlgete otsingut, kui töötad inglise sisuga
- Ehitusprotsessid võivad esimesel korral olla aeglased (npm install, Vite build)
## Turvaküsimused
## Turvalisuse kaalutlused
### Keskkonnamuutujad
- API võtmeid ei tohi kunagi commitida hoidlasse
- Kasuta `.env` faile (juba `.gitignore`-s)
- Dokumenteeri nõutud keskkonnamuutujad projektide README-des
- API võtmeid ei tohiks kunagi hoidlas salvestada
- Kasuta `.env` faile (on juba `.gitignore`-s)
- Dokumendi vajalikud keskkonnamuutujad projektide README-des
### Python projektid
- Kasuta virtuaalkeskkondi: `python -m venv venv`
- Hoia sõltuvusi ajakohasena
- GitHub tokenitel peaks olema miinimum vajalikud õigused
- Hoia sõltuvused ajakohased
- GitHubi tokenitel peaksid olema minimaalsed vajalikud õigused
### GitHub Models ligipääs
### GitHubi mudelite ligipääs
- Isikliku ligipääsu tokeni (PAT) nõutakse GitHub Models jaoks
- Toksid tuleks hoida keskkonnamuutujatena
- Mitte kunagi ei commitiks tokeneid ega volitusi
- Persoontõendid (PAT) on vajalikud GitHubi mudelite jaoks
- Tokenid tuleks hoida keskkonnamuutujatena
- Ära kunagi salvesta tokeneid ega mandaate hoidlas
## Lisamärkused
### Sihtgrupp
- Täielikud veebiarenduse algajad
- Õpilased ja isetegijad
- Täielikud algajad veebiarenduses
- Õpilased ja iseseisvalt õppijad
- Õpetajad, kes kasutavad õppekava klassiruumis
- Sisu on loodud ligipääsetavaks ja oskuste järk-järguliseks arendamiseks
- Sisu on loodud ligipääsetavaks ja oskuste järkjärguliseks arendamiseks
### Haridusfilosoofia
### Hariduslik filosoofia
- Projektipõhine õppemeetod
- Sageli tehtavad teadmiste kontrollid (viktoriinid)
- Käed-külge kodeerimise harjutused
- Reaalmaailma rakenduste näited
- Keskendumine põhialustele enne raamistikke
- Sage teadmiste kontroll (viktoriinid)
- Praktilised programmeerimisülesanded
- Reaalse maailma rakendusnäited
- Fookus alustel enne raamistikke
### Hoidla hooldus
- Aktiivne kogukond õppijate ja panustajatega
- Aktiivne õppijate ja panustajate kogukond
- Regulaarne sõltuvuste ja sisu uuendamine
- Probleemide ja arutelude jälgimine hooldajate poolt
- Tõlkeuuendused automatiseeritud GitHub Actions abil
- Vead ja arutelud jälgitavad hooldajate poolt
- Tõlgete värskendused automatiseeritud GitHub Actions abil
### Seotud ressursid
- [Microsoft Learn moodulid](https://docs.microsoft.com/learn/)
- [Õpilaskeskuse ressursid](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot), soovitatav õppijatele
- Lisa kursused: Generatiivne AI, Andmeteadus, ML, IoT õppekavad saadaval
- [Student Hub ressursid](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) soovitatud õppijatele
- Täiendavad kursused: Generatiivne tehisintellekt, andmeteadus, masinõpe, IoT õppekavad
### Töötamine spetsiifiliste projektidega
Detailse juhendi jaoks üksikprojektidele vaata README faile:
- `quiz-app/README.md` - Vue 3 viktoriini rakendus
- `7-bank-project/README.md` - Panga rakendus autentimisega
- `5-browser-extension/README.md` - Brauserilaienduse arendus
- `6-space-game/README.md` - Canvas baasil mängu arendus
Põhjalike juhiste saamiseks vaata vastavate projektide README faile:
- `quiz-app/README.md` - Vue 3 viktoriinirakendus
- `7-bank-project/README.md` - Pangaline rakendus koos autentimisega
- `5-browser-extension/README.md` - Brauserilaiendi arendus
- `6-space-game/README.md` - Canvas-põhine mänguarendus
- `9-chat-project/README.md` - AI juturoboti projekt
### Monorepo struktuur
@ -397,12 +397,12 @@ Detailse juhendi jaoks üksikprojektidele vaata README faile:
Kuigi see ei ole traditsiooniline monorepo, sisaldab see hoidla mitut iseseisvat projekti:
- Iga õppetund on iseseisev
- Projektid ei jaga sõltuvusi
- Töötage üksikute projektidega mõjutamata teisi
- Klooni kogu hoidla tervikliku õppekava kogemuse jaoks
- Töötada saab individuaalsete projektidega mõjutamata teisi
- Klooni kogu hoidla, et saada täielik õppekava kogemus
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Vastutusest loobumine**:
See dokument on tõlgitud AI tõlketeenuse [Co-op Translator](https://github.com/Azure/co-op-translator) abil. Kuigi püüdleme täpsuse poole, palun arvestage, et automaatsed tõlked võivad sisaldada vigu või ebatäpsusi. Algne dokument selle emakeeles tuleks pidada autoriteetseks allikaks. Olulise teabe puhul soovitatakse kasutada professionaalset inimtõlget. Me ei vastuta käesoleva tõlke kasutamisest tulenevate arusaamatuste või valesti tõlgenduste eest.
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, tuleb arvestada, et automaatsed tõlked võivad sisaldada vigu või ebatäpsusi. Originaaldokument selle emakeeles tuleks lugeda autoriteetse allikana. Kõrge tähtsusega teabe puhul soovitatakse kasutada professionaalset inimtõlget. Me ei vastuta selle tõlke kasutamisest tingitud arusaamatuste või valesti mõistmiste eest.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T12:12:20+00:00",
"translation_date": "2026-02-06T13:34:09+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 beginners. Di curriculum na one complete 12-week course wey Microsoft Cloud Advocates develop, wey get 24 hands-on lessons wey cover JavaScript, CSS, and HTML.
Dis na wan educational curriculum repository wey dem take teach web development fundamentals to beginners. Di curriculum na wan full 12-week course wey Microsoft Cloud Advocates develop, e get 24 hands-on lessons wey cover JavaScript, CSS, and HTML.
### Key Components
- **Educational Content**: 24 structured lessons wey arrange inside 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 with 3 questions each (pre/post-lesson assessments)
- **Multi-language Support**: Automated translations for 50+ languages via GitHub Actions
- **Interactive Quizzes**: 48 quizzes wey get 3 questions each (pre/post-lesson assessments)
- **Multi-language Support**: Automated translations for 50+ languages through GitHub Actions
- **Technologies**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (for AI projects)
### Architecture
- Educational repository wey get lesson-based structure
- Educational repository with lesson-based structure
- Each lesson folder get README, code examples, and solutions
- Standalone projects dey inside separate directories (quiz-app, various lesson projects)
- Standalone projects dey for different directories (quiz-app, different lesson projects)
- Translation system wey use GitHub Actions (co-op-translator)
- Documentation serve through Docsify and e de available as PDF
- Documentation dey inside Docsify and e still dey available as PDF
## Setup Commands
Dis repository na mainly for educational content consumption. To wok with specific projects:
Dis repository na mainly for educational content consumption. If you wan work with specific projects:
### Main Repository Setup
@ -46,9 +46,9 @@ npm run lint # Run ESLint
```bash
cd 7-bank-project/api
npm install
npm start # Start di API server
npm start # Strat API saba
npm run lint # Run ESLint
npm run format # Format wit Prettier
npm run format # Make e fine wit Prettier
```
### Browser Extension Projects
@ -56,7 +56,7 @@ npm run format # Format wit Prettier
```bash
cd 5-browser-extension/solution
npm install
# Follow di browser-specific instructions for loading extension
# Follow browser-specific extension loading instructions for how to put di extension inside di browser
```
### Space Game Projects
@ -82,19 +82,19 @@ python api.py
1. **Fork di repository** go your GitHub account
2. **Clone your fork** for your local machine
3. **Create new branch** for your changes
3. **Create new branch** for di changes wey you wan do
4. Change lesson content or code examples
5. Test any code changes for the correct project directories
6. Submit pull requests wey follow contribution guidelines
5. Test any code changes inside di relevant project directories
6. Submit pull requests as per contribution guidelines
### For Learners
1. Fork or clone di repository
2. Go lesson directories one by one
2. waka go lesson directories one after di other
3. Read README files for each lesson
4. Complete pre-lesson quizzes for https://ff-quizzes.netlify.app/web/
5. Work through code examples for lesson folders
6. Finish assignments and challenges
5. Work through code examples inside lesson folders
6. Complete assignments and challenges
7. Take post-lesson quizzes
### Live Development
@ -102,7 +102,7 @@ python api.py
- **Documentation**: Run `docsify serve` for root (port 3000)
- **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 correct API directories
- **API Projects**: Run `npm start` for respective API directories
## Testing Instructions
@ -110,33 +110,33 @@ 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 lint # Check whether code get style wahala
npm run build # Make sure say build succeed
```
### Bank API Testing
```bash
cd 7-bank-project/api
npm run lint # Check for code style wahala
node server.js # Confirm say server dey start without gbege
npm run lint # Check if code style get problem
node server.js # Make sure server fit start without wahala
```
### General Testing Approach
- Dis na educational repository without full automated tests
- Manual testing dey focus on:
- Code examples run without error
- Links for documentation dey work well
- Project builds complete successfully
- Examples dey follow best practices
- Dis na educational repository wey no get full automated tests
- Manual testing focus for:
- Code examples wey run without errors
- Links for documentation dey work correct
- Project builds complete well
- Examples follow best practices
### Pre-submission Checks
- Run `npm run lint` inside directories wey get package.json
- Confirm markdown links dey valid
- Run `npm run lint` for directories with package.json
- Check markdown links whether dem valid
- Test code examples for browser or Node.js
- Check say translations still get correct structure
- Make sure translations hold correct structure
## Code Style Guidelines
@ -144,48 +144,48 @@ node server.js # Confirm say server dey start without gbege
- Use modern ES6+ syntax
- Follow standard ESLint configurations wey projects provide
- Use meaningful variable and function names to help understanding
- Add comments wey explain concepts for learners
- Format with Prettier if e dey configured
- Use meaningful variable and function names wey fit educational clarity
- Add comments wey go explain concepts for learners
- Format code with Prettier where e dey configured
### HTML/CSS
- Use semantic HTML5 elements
- Semantic HTML5 elements
- Responsive design principles
- Clear class naming styles
- Clear class naming conventions
- Comments wey explain CSS techniques for learners
### Python
- Follow PEP 8 style guidelines
- Use clear, educational code examples
- Add Type hints if e fit help learning
- PEP 8 style guidelines
- Clear, educational code examples
- Use type hints if e help learning
### Markdown Documentation
- Clear heading hierarchy
- Code blocks with language specified
- Links to extra resources
- Screenshots and images inside `images/` folders
- Code blocks get language specification
- Links to more resources
- Screenshots and images inside `images/` directories
- Alt text for images for accessibility
### File Organization
- Lessons numbered one-after-another (1-getting-started-lessons, 2-js-basics, etc.)
- Each project get `solution/` and normally `start/` or `your-work/` folders
- Images dey for lesson-specific `images/` folders
- Translations dey inside `translations/{language-code}/` folders
- Lessons dey number in order (1-getting-started-lessons, 2-js-basics, etc.)
- Each project get `solution/` and most times `start/` or `your-work/` directories
- Images dey inside lesson-specific `images/` folders
- Translations dey for `translations/{language-code}/` structure
## Build and Deployment
### Quiz App Deployment (Azure Static Web Apps)
Di quiz-app configure 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 make dist/ folder
# Dey deploy wit GitHub Actions workflow wen dem push for main branch
npm run build # Dey create dist/ folder
# Dey deploy wit GitHub Actions workflow wen you push to main
```
Azure Static Web Apps configuration:
@ -203,8 +203,8 @@ npm run convert # Make PDF from docs
### Docsify Documentation
```bash
npm install -g docsify-cli # Install Docsify for everywhere for your system
docsify serve # Run am for localhost:3000
npm install -g docsify-cli # Install Docsify for everywhere
docsify serve # Run for localhost:3000
```
### Project-specific Builds
@ -217,7 +217,7 @@ Each project directory fit get im own build process:
### Title Format
Use clear, descriptive titles wey show di area of change:
Use clear, descriptive titles wey dey show area wey you change:
- `[Quiz-app] Add new quiz for lesson X`
- `[Lesson-3] Fix typo for terrarium project`
- `[Translation] Add Spanish translation for lesson 5`
@ -228,35 +228,35 @@ Use clear, descriptive titles wey show di area of change:
Before you submit PR:
1. **Code Quality**:
- Run `npm run lint` for affected project directories
- Run `npm run lint` inside projects you change
- Fix all linting errors and warnings
2. **Build Verification**:
- Run `npm run build` if e necessary
- Run `npm run build` if e apply
- Make sure no build errors
3. **Link Validation**:
- Test all markdown links
- Confirm image references work
- Check if images dem work
4. **Content Review**:
- Proofread for grammar and spelling
- Ensure code examples correct and educational
- Proofread for spelling and grammar
- Make sure code examples correct and dey educational
- Confirm translations maintain original meaning
### Contribution Requirements
- Agree to Microsoft CLA (e dey automatic on first PR)
- Agree to Microsoft CLA (automatic check on first PR)
- Follow [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Check [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed guidelines
- Reference issue numbers inside PR description if necessary
- See [CONTRIBUTING.md](./CONTRIBUTING.md) for full guidelines
- Mention issue numbers for PR description if e dey
### Review Process
- PRs go through review by maintainers and community
- PRs go reviewed by maintainers and community
- Educational clarity dey priority
- Code examples suppose follow current best practices
- Translations go through review for correctness and cultural appropriateness
- Translations go reviewed for accuracy and cultural fit
## Translation System
@ -265,11 +265,11 @@ Before you submit PR:
- E dey use GitHub Actions with co-op-translator workflow
- E dey translate to 50+ languages automatically
- Source files dey main directories
- Translated files dey inside `translations/{language-code}/` folders
- Translated files dey `translations/{language-code}/` directories
### Adding Manual Translation Improvements
1. Find file inside `translations/{language-code}/`
1. Find file for `translations/{language-code}/`
2. Make improvements but keep original structure
3. Make sure code examples still dey work
4. Test any localized quiz content
@ -295,40 +295,40 @@ CO_OP_TRANSLATOR_METADATA:
**Quiz app no fit start**:
- Check Node.js version (v14+ recommended)
- Delete `node_modules` and `package-lock.json`, run `npm install` again
- Check port conflicts (Vite normally use port 5173)
- Delete `node_modules` and `package-lock.json`, then run `npm install` again
- Check for port conflicts (default: Vite use port 5173)
**API server no fit start**:
- Confirm Node.js version at least (node >=10)
- Check if port dey already in use
**API server no go start**:
- Confirm Node.js version get minimum (node >=10)
- Check if port dey already busy
- Make sure all dependencies install with `npm install`
**Browser extension no dey load**:
- Confirm manifest.json proper format
- Confirm manifest.json well formatted
- Check browser console for errors
- Follow browser-specific extension installation instructions
**Python chat project wahala**:
**Python chat project get wahala**:
- Confirm OpenAI package install: `pip install openai`
- Confirm GITHUB_TOKEN environment variable set
- Check GitHub Models access permissions
**Docsify no dey serve docs**:
- Install docsify-cli globally: `npm install -g docsify-cli`
- Run am from repository root directory
- Confirm say `docs/_sidebar.md` dey
- Run from repository root directory
- Check if `docs/_sidebar.md` dey
### Development Environment Tips
- Use VS Code with Live Server extension for HTML projects
- Install ESLint and Prettier extensions for consistent formatting
- Use browser DevTools to debug JavaScript
- Install ESLint and Prettier extensions for steady formatting
- Use browser DevTools for JavaScript debugging
- For Vue projects, install Vue DevTools browser extension
### Performance Considerations
- Big number of translated files (50+ languages) mean full clones big
- Use shallow clone if you dey work only on content: `git clone --depth 1`
- Plenty translated files (50+ languages) mean full clones large
- Use shallow clone if you dey work on content only: `git clone --depth 1`
- Exclude translations from searches if you dey work on English content
- Build processes fit slow for first run (npm install, Vite build)
@ -336,19 +336,19 @@ CO_OP_TRANSLATOR_METADATA:
### Environment Variables
- API keys no suppose commit inside repository
- Use `.env` files (dem already dey `.gitignore`)
- Document which environment variables project READMEs need
- API keys no suppose ever commit to repository
- Use `.env` files (dem already inside `.gitignore`)
- Document required environment variables for project READMEs
### Python Projects
- Use virtual environments: `python -m venv venv`
- Keep dependencies updated
- GitHub tokens suppose get minimal permissions
- GitHub tokens need minimal permissions needed
### GitHub Models Access
- Personal Access Tokens (PAT) necessary for GitHub Models
- Personal Access Tokens (PAT) dey required for GitHub Models
- Tokens suppose dey stored as environment variables
- No ever commit tokens or credentials
@ -356,10 +356,10 @@ CO_OP_TRANSLATOR_METADATA:
### Target Audience
- Complete beginners for web development
- Absolute beginners to web development
- Students and self-learners
- Teachers wey dey use curriculum for classrooms
- Content design for accessibility and gradual skill building
- Teachers wey dey use the curriculum for classrooms
- Content designed for accessibility and gradual skill building
### Educational Philosophy
@ -373,19 +373,19 @@ CO_OP_TRANSLATOR_METADATA:
- Active community of learners and contributors
- Regular updates to dependencies and content
- Issues and discussions dey monitored by maintainers
- Translation updates automatic with GitHub Actions
- Issues and discussions monitored by maintainers
- 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
- Additional courses: Generative AI, Data Science, ML, IoT curricula dey available
- Additional courses: Generative AI, Data Science, ML, IoT curricula available
### Working with Specific Projects
For detailed instructions about each project, check README files inside:
For detailed instructions on individual projects, check README files inside:
- `quiz-app/README.md` - Vue 3 quiz application
- `7-bank-project/README.md` - Banking application with authentication
- `5-browser-extension/README.md` - Browser extension development
@ -394,15 +394,15 @@ For detailed instructions about each project, check README files inside:
### Monorepo Structure
Even though e no traditional monorepo, dis repository get plenty independent projects:
- Each lesson self-contained
Although e no be normal monorepo, dis repository get many independent projects:
- Each lesson dey self-contained
- Projects no dey share dependencies
- Work on individual projects without affecting others
- Fit work on individual projects no wahala with others
- Clone whole repo to get full curriculum experience
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Disclaimer**:
Dis document 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 translation fit get mistake or no too correct. Di original document wey pure for im own language na di main correct source. For important tin dem, e better make person wey sabi do professional translation make am. We no go follow any wahala or mistake Wey fit show because of dis translation.
Dis dokument dem don use AI translation service wey dem call [Co-op Translator](https://github.com/Azure/co-op-translator) translate am. Even though we dey try make am correct, abeg sabi say automated translation fit get some mistake or small wahala. Di ogbonge dokument for dia original language na im be di correct one. If na serious matter, e better make person wey sabi human translation do am. We no go follow any misunderstanding or wrong meaning wey fit show from dis translation.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T12:13:33+00:00",
"translation_date": "2026-02-06T13:35:30+00:00",
"source_file": "AGENTS.md",
"language_code": "te"
},

@ -1,282 +1,282 @@
# AGENTS.md
## Project Overview
## ప్రాజెక్ట్ అవలోకనం
ఇది ప్రారంభ దశలో ఉన్నవారికి వెబ్ అభివృద్ధి ప్రాథమికాలు బోధించడానికి రూపొందించిన విద్యా పాఠ్యక్రమ కంప్యూటర్‌స్టోర్. ఈ పాఠ్యక్రమం Microsoft Cloud Advocates ద్వారా అభివృద్ధి చేయబడిన సమగ్రమైన 12 వారాలు కోర్సు, దీనిలో JavaScript, CSS, మరియు HTML ను కవరుచేసే 24 చేతితో పని చేసే పాఠాలు ఉన్నాయి.
ఇది కొత్తవారికి వెబ్ అభివృద్ధి మౌలిక విషయాలు నేర్పుకునేందుకు విద్యా కోర్సు నిల్వ(repositary). ఈ కోర్సు Microsoft Cloud Advocates వారు రూపొందించిన 12 వారాల సమగ్ర కోర్సు, జావాస్క్రిప్ట్, CSS, HTML పై 24 చేతితో నేర్చుకునే పాఠాలు కలిగివున్నది.
### Key Components
### ప్రధాన భాగాలు
- **విద్యా విషయం**: ప్రాజెక్టు ఆధారిత మాడ్యూల్స్ లో 24 నిర్మిత పాఠాలు
- **ప్రాక్టికల్ ప్రాజెక్టులు**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, మరియు AI చాట్ అసిస్టెంట్
- **ఇంటరాక్టివ్ క్విజ్‌లు**: 3 ప్రశ్నలతో 48 క్విజ్‌లు (పాఠం ముందు / తర్వాత మూల્યાંకనలు)
- **బహుభాషా మద్దతు**: GitHub Actions ద్వారా 50+ భాషల ఆటోమటెడ్ అనువాదాలు
- **సాంకేతికతలు**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI ప్రాజెక్టులకు)
- **విద్యా విషయం**: ప్రాజెక్ట్ ఆధారిత మాడ్యూల్స్‌లో 24 నిర్మిత పాఠాలు
- **ప్రాక్టికల్ ప్రాజెక్టులు**: Terrarium, టైపింగ్ ఆట, బ్రౌజర్ విస్తరణ, స్పేస్ గేమ్, బ్యాంకింగ్ యాప్, కోడ్ ఎడిటర్, AI చాట్ సహాయకుడు
- **ఇంటరాక్టివ్ క్విజ్‌లు**: 3 ప్రశ్నలతో 48 క్విజ్‌లు (పాఠం ముందరి/తర్వాత)
- **బహుభాషా మద్దతు**: GitHub Actions ద్వారా 50+ భాషల ఆటోమటెడ్ అనువాదాలు
- **సాంకేతికతలు**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI ప్రాజెక్టుల కోసం)
### Architecture
### ఆర్కిటెక్చర్
- పాఠ్యాల ఆధారంగా నిర్మిత విద్యా కంప్యూటర్‌స్టోర్
- ప్రతి పాఠం ఫోల్డర్‌లో README, కోడ్ ఉదాహరణలు మరియు పరిష్కారాలు ఉంటాయి
- క్విజ్-యాప్, వివిధ పాఠ ప్రాజెక్టులు వేర్వేరు డైరెక్టరీలలో నిల్వ
- పాఠ ఆధారిత నిర్మాణం కలిగిన విద్యా నిల్వ
- ప్రతి పాఠం ఫోల్డరు లో README, కోడ్ ఉదాహరణలు, పరిష్కారాలు ఉంటాయి
- విడిభిన్న డైరెక్టరీలలో స్వతంత్ర ప్రాజెక్టులు (quiz-app, వివిధ పాఠ ప్రాజెక్టులు)
- GitHub Actions ఉపయోగించి అనువాద వ్యవస్థ (co-op-translator)
- Docsify ద్వారా డాక్యుమెంటేషన్ అందుబాటులో, PDF లాగా అందుబాటు
- Docsify ద్వారా డాక్యుమెంటేషన్ అందుబాటులో, PDF ఫార్మాట్ గా కూడా
## Setup Commands
## సెటప్ కమాండ్లు
కంప్యూటర్‌స్టోర్ ప్రాథమికంగా విద్యా విషయాలను వినియోగించుకోుము కోసం ఉంది. నిర్దిష్ట ప్రాజెక్టులతో పనిచేయడానికి:
నిల్వ ప్రధానంగా విద్యా విషయాల వినియోగం కోసం. ప్రత్యేక ప్రాజెక్టులతో పనిచేయడానికి:
### Main Repository Setup
### ప్రధాన నిల్వ సెటప్
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### Quiz App Setup (Vue 3 + Vite)
### క్విజ్ యాప్ సెటప్ (Vue 3 + Vite)
```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)
### బ్యాంక్ ప్రాజెక్ట్ API (Node.js + Express)
```bash
cd 7-bank-project/api
npm install
npm start # API సర్వర్ ప్రారంభించండి
npm start # API సర్వర్‌ను ప్రారంభించండి
npm run lint # ESLint నడపండి
npm run format # Prettier తో ఫార్మాట్ చేయండి
```
### Browser Extension Projects
### బ్రౌజర్ విస్తరణ ప్రాజెక్టులు
```bash
cd 5-browser-extension/solution
npm install
# బ్రౌసర్-ప్రత్యేక సవరణ లోడ్ చేయడం సంబంధిత సూచనలను అనుసరించండి
# బ్రౌజర్-ప్రత్యేక ఎక్స్‌టెన్షన్ లోడింగ్ సూచనలను అనుసరించండి
```
### Space Game Projects
### స్పేస్ గేమ్ ప్రాజెక్టులు
```bash
cd 6-space-game/solution
npm install
# బ్రౌజర్‌లో index.html ను తెరవండి లేదా లైవ్ సర్వర్‌ని ఉపయోగించండి
# బ్రౌజర్‌లో index.html ను తెరవండి లేదా లైవ్ సర్వర్ ఉపయోగించండి
```
### Chat Project (Python Backend)
### చాట్ ప్రాజెక్ట్ (Python బ్యాక్‌ఎండ్)
```bash
cd 9-chat-project/solution/backend/python
pip install openai
# GITHUB_TOKEN పర్యావరణ వేరియబుల్ సెట్ చేయండి
# GITHUB_TOKEN వాతావరణ చరంవారిని సెట్ చేయండి
python api.py
```
## అభివృద్ధి వర్క్‌ఫ్లో
## Development Workflow
### For Content Contributors
### కంటెంట్ కంట్రీబ్యూటర్‌ల కోసం
1. **మీ GitHub ఖాతాకు ఈ కంప్యూటర్‌స్టోర్ ను Fork చేయండి**
2. **మీ Fork ను స్థానికంగా Clone చేయండి**
1. **నిల్వను ఫోర్క్ చేయండి** మీ GitHub ఖాతాకు
2. **ఫోర్క్‌ను లోకల్‌కు క్లోన్ చేయండి**
3. **మీ మార్పులకు కొత్త బ్రాంచ్ సృష్టించండి**
4. పాఠ విషయాలు లేదా కోడ్ ఉదాహరణల్లో మార్పులు చేయండి
4. పాఠ విషయములు లేదా కోడ్ ఉదాహరణల్లో మార్పులు చేయండి
5. సంబంధిత ప్రాజెక్టు డైరెక్టరీలలో కోడ్ మార్పులను పరీక్షించండి
6. సహకార మార్గదర్శకాలు పర్యవేక్షించి Pull Requests సమర్పించండి
6. సహాయం మార్గదర్శకాల ప్రకారం పుల్ రిక్వెస్ట్‌లు సమర్పించండి
### For Learners
### అభ్యర్థుల కొరకు
1. Fork చేయండి లేదా కంప్యూటర్‌స్టోర్ ను Clone చేయండి
2. పాఠ డైరెక్టరీలను వరుసగా సందర్శించండి
3. ప్రతి పాఠం README ఫైల్స్ చదవండి
4. https://ff-quizzes.netlify.app/web/ వద్ద పాఠం ముందు క్విజ్‌లు పూర్తి చేయండి
5. పాఠ ఫోల్డర్లలో కోడ్ ఉదాహరణలలో పని చేయండి
6. అసైన్మెంట్లు మరియు సవాళ్లు పూర్తి చేయండి
1. నిల్వను ఫోర్క్ లేదా క్లోన్ చేయండి
2. పాఠాల డైరెక్టరీలలో వరుసగా నావిగేట్ అవ్వండి
3. ప్రతి పాఠం కోసం README ఫైళ్లు చదవండి
4. https://ff-quizzes.netlify.app/web/ వద్ద పాఠం ముందు క్విజ్‌లు పూర్తి చేయండి
5. పాఠ ఫోల్డర్‌లలో కోడ్ ఉదాహరణలను ఉపయోగించండి
6. అస్సైన్మెంట్లు మరియు సవాళ్లు పూర్తి చేయండి
7. పాఠం తర్వాత క్విజ్‌లు తీసుకోండి
### Live Development
### లైవ్ డెవలప్మెంట్
- **డాక్యుమెంటేషన్**: రూట్ డైరెక్టరీలో `docsify serve` నడపండి (పోర్ట్ 3000)
- **క్విజ్ యాప్**: quiz-app డైరెక్టరీలో `npm run dev` నడపండి
- **ప్రాజెక్టులు**: HTML ప్రాజెక్టులకు VS Code Live Server extension ఉపయోగించండి
- **API ప్రాజెక్టులు**: సంబంధిత API డైరెక్టరీలలో `npm start` నడపండి
- **డాక్యుమెంటేషన్**: రూట్ లో `docsify serve` అమలు చేయండి (పోర్టు 3000)
- **క్విజ్ యాప్**: quiz-app డైరెక్టరీలో `npm run dev` అమలు చేయండి
- **ప్రాజెక్టులు**: VS Code లైవ్ సర్వర్ ఎక్స్‌టెన్షన్‌ను HTML ప్రాజెక్టులకి ఉపయోగించండి
- **API ప్రాజెక్టులు**: సంబంధిత API డైరెక్టరీలలో `npm start` అమలు చేయండి
## Testing Instructions
## పరీక్షించు సూచనలు
### Quiz App Testing
### క్విజ్ యాప్ పరీక్ష
```bash
cd quiz-app
npm run lint # కోడ్ శైల సమస్యలను తనిఖీ చేయండి
npm run build # బిల్డ్ విజయవంతమైందని నిర్ధారించండి
npm run lint # కోడ్ శైలి సమస్యలను తనిఖీ చేయండి
npm run build # బిల్డ్ విజయవంతమవుతుందో నిర్ధారించండి
```
### Bank API Testing
### బ్యాంక్ API పరీక్ష
```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 సాంకేతికతలను వివరించే కామెంట్లు
- సేమాంటిక్ HTML5 ఎలిమెంట్లు
- ప్రతిస్పందనాత్మక డిజైన్ ప్రిన్సిపిల్స్
- స్పష్టమైన క్లాస్ పేర్ల నియమాలు
- CSS సాంకేతికతలకు వివరణాత్మక వ్యాఖ్యలు
### Python
- PEP 8 స్టైల్ మార్గదర్శకాలు
- స్పష్టమైన, విద్యా పరమైన కోడ్ ఉదాహరణలు
- అభ్యాసకులకు ఉపయోగకరమైన చోట టైప్ హింట్స్
- PEP 8 శైలి మార్గదర్శకాలు
- స్పష్టమైన, విద్యా కోడ్ ఉదాహరణలు
- నేర్చుకోవడంపై సహాయకమైన టైప్ హింట్లు
### Markdown Documentation
### Markdown డాక్యుమెంటేషన్
- స్పష్టమైన శీర్షిక జైలిమవర్డ్
- భాషా పేర్కొన్న కోడ్ బ్లాక్స్
- అదనపు వనరుల లింకులు
- `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)
### క్విజ్ యాప్ డిప్లాయ్‌మెంట్ (Azure Static Web Apps)
క్విజ్-యాప్ Azure Static Web Apps ప్రవేశపెట్టడానికి బాగా సర్దుబాటు చేయబడింది:
క్విజ్ యాప్ Azure Static Web Apps కోసం సెటప్:
```bash
cd quiz-app
npm run build # dist/ ఫోల్డర్ సృష్టిస్తుంది
# ప్రధాన బ్రాంచ్‌కు పుష్ చేసినప్పుడు GitHub Actions వర్క్‌ఫ్లో ద్వారా పంపిస్తుంది
npm run build # dist/ ఫోల్డర్ ను సృష్టిస్తుంది
# ప్రధాన బ్రాంచ్‌కు పుష్ చేయగానే GitHub Actions వర్క్‌ఫ్లో ద్వారా మోపుతుంది
```
Azure Static Web Apps కాన్ఫిగరేషన్:
- **యాప్ స్థానం**: `/quiz-app`
- **ఫలిత స్థానం**: `dist`
- **వర్క్‌ఫ్లో**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
Azure Static Web Apps కాన్ఫిగరేషన్:
- **App location**: `/quiz-app`
- **Output location**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Documentation PDF Generation
### డాక్యుమెంటేషన్ PDF తయారీ
```bash
npm install # docsify-to-pdf ను ఇన్‌స్టాల్ చేయండి
npm run convert # docs నుండి PDF ను సృష్టించండి
npm install # docsify-to-pdfని ఇన్‌స్టాల్ చేయండి
npm run convert # డాక్స్ నుండి PDF ఉత్పత్తి చేయండి
```
### Docsify Documentation
### Docsify డాక్యుమెంటేషన్
```bash
npm install -g docsify-cli # Docsify ని గ్లోబల్గా ఇన్‌స్టాల్ చేయండి
npm install -g docsify-cli # Docsify ను గ్లోబల్లీ ఇన్స్టాల్ చేయండి
docsify serve # localhost:3000 పై సర్వ్ చేయండి
```
### ప్రాజెక్ట్ ప్రత్యేక బిల్డులు
### Project-specific Builds
ప్రతి ప్రాజెక్ట్ డైరెక్టరీకు తన ప్రత్యేక బిల్డ్ ప్రక్రియ ఉండవచ్చు:
- Vue ప్రాజెక్టులు: `npm run build` ద్వారా ప్రొడక్షన్ బండిల్స్ సృష్టించబడతాయి
- స్టాటిక్ ప్రాజెక్టులు: బిల్డ్ దశ ఉండదు, ఫైళ్ళను నేరుగా సర్వ్ చేస్తారు
ప్రతి ప్రాజెక్ట్ డైరెక్టరీ యొక్క ప్రత్యేక బిల్డ్ ప్రాసెస్ ఉండవచ్చు:
- Vue ప్రాజెక్టులకి: `npm run build` ప్రొడక్షన్ బండిల్స్ సృష్టిస్తుంది
- స్థిర ప్రాజెక్టులకి: బిల్డ్ లేదండి, ఫైళ్లను నేరుగా సర్వ్ చేయండి
## Pull Request Guidelines
## పుల్ రిక్వెస్ట్ మార్గదర్శకాలు
### Title Format
### శీర్షిక ఫార్మాట్
మార్పుల ప్రాంతాన్ని స్పష్టంగా తెలిపే శీర్షికలను ఉపయోగించండి:
- `[Quiz-app] పాఠం X కోసం కొత్త క్విజ్ జోడించండి`
- `[Lesson-3] terrarium ప్రాజెక్టులో టైపో సరిదిద్దండి`
- `[Translation] పాఠం 5కి స్పానిష్ అనువాదం జోడించండి`
మార్పు ప్రాంతం సూచించే స్పష్టమైన శీర్షికలు ఉపయోగించండి:
- `[Quiz-app] పాఠం X కొరకు కొత్త క్విజ్ జోడించండి`
- `[Lesson-3] టెర్రేరియం ప్రాజెక్ట్ లో టైపో సరిచేయండి`
- `[Translation] పాఠం 5 కోసం స్పానిష్ అనువాదం జోడించండి`
- `[Docs] సెటప్ సూచనలను నవీకరించండి`
### Required Checks
### అవసరమైన తనిఖీలు
PR సమర్పించేముందు:
1. **కోడ్ నాణ్యత**:
- ప్రభావిత ప్రాజెక్ట్ డైరెక్టరీలలో `npm run lint` నడపండి
- అన్ని లింటింగ్ లోపాలు మరియు హెచ్చరికలు సరి చేసుకోండి
1. **కోడ్ నాణ్యత**:
- ప్రభావిత ప్రాజెక్టు డైరెక్టరీలలో `npm run lint` అమలు చేయండి
- అన్ని లింటింగ్ తప్పులు, హెచ్చరికలు సరిచేయండి
2. **బిల్డ్ నిర్ధారణ**:
- అవసరమైతే `npm run build` నడపండి
- ఎలాంటి బిల్డ్ లోపాలు లేవని నిర్ధారించండి
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 Actions తో co-op-translator workflow ఉపయోగిస్తుంది
- 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:
@ -288,121 +288,121 @@ CO_OP_TRANSLATOR_METADATA:
}
-->
```
## డీబగింగ్ మరియు సమస్య పరిష్కారం
## Debugging and Troubleshooting
### Common Issues
### సాధారణ సమస్యలు
**క్విజ్ యాప్ మొదలుపెట్టలేకపోతే**:
- 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` ద్వారా ఇన్స్టాల్ అయ్యాయా చూసుకోండి
**బ్రౌజర్ ఎక్స్‌టెన్షన్ లోడ్ అవడం లేదు**:
- manifest.json సరైన ఫార్మాట్ లో ఉందో చూసుకోండి
- బ్రౌజర్ కన్సోల్ లో ఎర్రర్లు గమనించండి
- బ్రౌజర్ ప్రత్యేక ఎక్స్‌టెన్షన్ ఇన్స్టలేషన్ సూచనలను అనుసరించండి
**బ్రౌజర్ ఎక్స్‌టెన్షన్ లోడ్ అవకపోవడం**:
- manifest.json సరైన ఫార్మాట్ లో ఉందా చెక్ చేయండి
- బ్రౌజర్ కన్సోల్ లో ఏ తప్పులున్నారు అంటే చూడండి
- బ్రౌజర్ ప్రత్యేక ఎక్స్‌టెన్షన్ ఇన్స్టలేషన్ సూచనలను అనుసరించండి
**Python చాట్ ప్రాజెక్ట్ సమస్యలు**:
- OpenAI ప్యాకేజ్ ఇన్‌స్టాల్ అయ్యి ఉందో చూడండి: `pip install openai`
- GITHUB_TOKEN పరిసర మార్పిడిని సెట్ చేయడం జరిగింది లేదా తనిఖీ చేయండి
- GitHub Models కి యాక్సెస్ అనుమతులు సరిచూడండి
**Python చాట్ ప్రాజెక్ట్ సమస్యలు**:
- OpenAI ప్యాకేజీ ఇన్స్టాల్ చేసారా: `pip install openai`
- GITHUB_TOKEN ఎన్విరాన్‌మెంట్ వేరియబుల్ సెట్ అయింది చూసుకోండి
- GitHub Models కి యాక్సెస్ అనుమతులు ఉన్నాయా తనిఖీ చేయండి
**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 extension ఉపయోగించండి
- నిరంతర ఫార్మాటింగ్ కి ESLint మరియు Prettier extensions ఇన్‌స్టాల్ చేయండి
- JavaScript డీబగ్గింగ్ కోసం బ్రౌజర్ DevTools ఉపయోగించండి
- Vue ప్రాజెక్టుల కోసం Vue DevTools బ్రౌజర్ ఎక్స్‌టెన్షన్ ఇన్‌స్టాల్ చేయండి
- HTML ప్రాజెక్టులకు VS Code లో Live Server ఎక్స్‌టెన్షన్ ఉపయోగించండి
- ESLint మరియు Prettier ఎక్స్‌టెన్షన్లు consistent formatting కోసం ఇన్స్టాల్ చేయండి
- జావాస్క్రిప్ట్ డీబగ్ కోసం బ్రౌజర్ డెవ్టూల్స్ ఉపయోగించండి
- Vue ప్రాజెక్టులకు Vue DevTools బ్రౌజర్ ఎక్స్‌టెన్షన్ ఉపయోగించండి
### Performance Considerations
### పనితీరు పరిగణనలు
- అనువదించబడిన ఫైళ్ళ సంఖ్య (50+ భాషలు) చాలా ఎక్కువగా ఉండటంతో పూర్తి క్లోన్ భారీగా ఉంటుంది
- కేవలం కంటెంట్ పై పని చేస్తున్నప్పుడు శలో క్లోన్ ఉపయోగించండి: `git clone --depth 1`
- ఆంగ్ల కంటెంట్ పై పని చేస్తున్నప్పుడు అనువాదాలను శోధనలకు అంతర్భాగంగా తీసుకోకూడదు
- మొదటి సారి నడిపే build ప్రక్రియలు నెమ్మదిగా ఉండవచ్చు (npm install, Vite build)
- అనువాదాల సంఖ్య ఎక్కువ (50+ భాషలు) మూలంగా పూర్తి క్లోన్‌లు పెద్దవి అవుతాయి
- కంటెంట్ పైన మాత్రమే పని చేస్తూ ఉంటే shallow clone ఉపయోగించండి: `git clone --depth 1`
- ఇంగ్లీష్ కంటెంట్ పని సమయంలో అనువాదాలను సెర్చ్ నుండి మినహాయించండి
- మొదటి సారి npm install, Vite build వంటి ప్రాసెస్‌లు స్లోగా ఉండొచ్చు
## Security Considerations
## భద్రత పరిగణనలు
### Environment Variables
### ఎన్విరాన్‌మెంట్ వేరియబుల్స్
- API కీలు ఎప్పుడూ కంప్యూటర్‌స్టోర్ లకు కమీట్చేయకూడదు
- `.env` ఫైళ్లను (.gitignore లో ఇప్పటికే ఉన్నాయి) ఉపయోగించండి
- ప్రాజెక్ట్ README లలో అవసరమైన పరిసర మార్పిడులను డాక్యుమెంట్ చేయండి
- API కీలు నిల్వలో commit చేయకూడదు
- `.env` ఫైళ్లను ఉపయోగించండి (ఇప్పటికే `.gitignore` లో ఉన్నాయి)
- అవసరమైన ఎన్విరాన్‌మెంట్ వేరియబుల్స్ README లలో డాక్యుమెంట్ చేయండి
### Python Projects
### Python ప్రాజెక్టులు
- వర్చువల్ ఎన్విరాన్‌మెంట్లు ఉపయోగించండి: `python -m venv venv`
- డిపెండెన్సీలు అప్డేట్ గా ఉంచండి
- GitHub టోకెన్లు కనీసం అవసరమయిన అనుమతులతో ఉండాలి
- వర్చువల్ ఎన్విరాన్‌మెంట్‌లు వాడండి: `python -m venv venv`
- డిపెండెన్సీలను నవీకరించండి
- GitHub టోకెన్‌లు కనీస అవసర అనుమతులే ఇవ్వండి
### GitHub Models Access
### GitHub Models యాక్సెస్
- GitHub Models కి Personal Access Tokens (PAT) అవసరం
- టోకెన్లను పరిసర మార్పిడులాగా నిల్వ చేయాలి
- టోకెన్లను లేదా క్రెడెన్షియల్స్ ఎప్పుడూ కమీట్ చేయకూడదు
- వ్యక్తిగత యాక్సెస్ టోకెన్లు (PAT) అవసరం
- టోకెన్లు ఎన్విరాన్‌మెంట్ వేరియబుల్స్ గా నిల్వ చేయాలి
- టోకెన్లు లేదా సీక్రెట్లను commit చేయవద్దు
## Additional Notes
## అదనపు గమనికలు
### Target Audience
### లక్ష్య ప్రేక్షకులు
- వెబ్ అభివృద్ధి విషయంలో పూర్తి ప్రారంభస్థాయి వ్యక్తులు
- విద్యార్థులు మరియు స్వీయ అభ్యాసకులు
- తరగతుల్లో ఈ పాఠ్యక్రమాన్ని ఉపయోగించే బోధకులు
- కంటెంట్ యాక్సెసిబిలిటీతో మరియు నెమ్మదిగా నైపుణ్యాల నిర్మాణంతో రూపొందించబడింది
- వెబ్ అభివృద్ధి కొత్తవారు
- విద్యార్థులు మరియు స్వీయ అభ్యాసకులు
- తరగతుల్లో ఈ కోర్సు ఉపయోగించే ఉపాధ్యాయులు
- సులభంగా చేరుకోగలిగే, క్రమంగా నైపుణ్యాలు పెంచే కంటెంట్
### Educational Philosophy
### విద్యా తత్వశాస్త్రం
- ప్రాజెక్టు ఆధారిత నేర్చుకోవడం విధానం
- తరచూ జ్ఞాన పరీక్షలు (క్విజ్‌లు)
- చేతితో కోడింగ్ అభ్యాసాలు
- వాస్తవ ప్రపంచ అప్లికేషన్ ఉదాహరణలు
- ఫ్రేమ్‌వర్క్‌ల ముందు ప్రాథమిక అంశాలపై దృష్టి
- ప్రాజెక్ట్-ఆధారిత నేర్చుకోవడం
- తరచూ జ్ఞాన పరీక్షలు (క్విజ్‌లు)
- చేతితో కోడింగ్ సాధన
- వాస్తవ ప్రపంచ అన్వయ ఉదాహరణలు
- ఫ్రేమ్‌వర్క్‌ల ముందే కాకండాౌలికాలపై దృష్టి
### Repository Maintenance
### నిల్వ నిర్వహణ
- శ్రద్ధగల అభ్యాసకులు మరియు సహకారుల సమాజం
- డిపెండెన్సీలు మరియు కంటెంట్ యొక్క నియమిత నవీకరణలు
- నిర్వహకులు ఇష్యూస్, చర్చలను పర్యవేక్షిస్తారు
- అనువాద నవీకరణలు ఆటోమేటెడ్ గా GitHub Actions ద్వారా జరుగుతాయి
- శ్రేయోభిరుచి ఉన్న అభ్యాసకులు, కాంట్రిబ్యూటర్లు ఉన్న క్రియాశీల సమూహం
- డిపెండెన్సీలు, కంటెంట్ శ్రద్ధగా అప్‌డేట్ చేయడం
- ఇష్యూలు, చర్చలు నిర్వాహకులు పర్యవేక్షణ
- అనువాద నవీకరణలు 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) అభ్యాసకులకు సిఫార్సు
- అదనపు కోర్సులు: Generative AI, Data Science, ML, 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) విద్యార్థులకు సిఫార్సు
- అదనపు కోర్సులు: 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` - క్యాన్వాస్ ఆధారిత ఆట అభివృద్ధి
ప్రత్యేక ప్రాజెక్టుల వివరాలకు 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 -->
**మరువొచ్చుట (డిస్క్లెయిమర్)**:
పత్రాన్ని 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