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

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

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T12:07:48+00:00",
"translation_date": "2026-02-06T13:29:43+00:00",
"source_file": "AGENTS.md",
"language_code": "lt"
},

@ -2,42 +2,42 @@
## Projekto apžvalga
Tai yra mokomojo turinio saugykla, skirta mokyti pradedančiuosius pagrindų apie interneto kūrimą. Mokymo programa yra visapusiškas 12 savaičių kursas, sukurtas Microsoft Cloud Advocates komandos, kuriame yra 24 praktinės pamokos, apimančios JavaScript, CSS ir HTML.
Tai mokymo programos saugykla, skirta mokyti pradedančiuosius pagrindų apie interneto kūrimą. Programa yra išsami 12 savaičių kursas, sukurtas Microsoft Cloud Advocates, apimantis 24 praktinius užsiėmimus apie JavaScript, CSS ir HTML.
### Pagrindinės sudedamosios dalys
- **Mokymo turinys**: 24 struktūruotos pamokos, suskirstytos į projektų modulius
- **Praktiniai projektai**: Terrarium, Raidžių spausdinimo žaidimas, Naršyklės plėtinys, Kosminis žaidimas, Banko programa, Kodo redaktorius ir DI pokalbių asistentas
- **Interaktyvūs testai**: 48 testai po 3 klausimus kiekviename (prieš pamoką ir po pamokos)
- **Daugiakalbė parama**: Automatiniai vertimai į daugiau nei 50 kalbų naudojant GitHub Actions
- **Mokomoji medžiaga**: 24 struktūrizuoti užsiėmimai, organizuoti į projektinius modulius
- **Praktiniai projektai**: Terariumas, Rašymo žaidimas, Naršyklės plėtinys, Kosminis žaidimas, Banko programa, Kodo redaktorius ir DI pokalbių asistentas
- **Interaktyvūs testai**: 48 testai po 3 klausimus kiekviename (prieš/po pamokos vertinimai)
- **Daugiakalbė palaikymas**: Automatizuoti vertimai į daugiau nei 50 kalbų per GitHub Actions
- **Technologijos**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (DI projektams)
### Architektūra
- Mokomojo turinio saugykla su pamokomis struktūroje
- Kiekviename pamokų kataloge yra README, kodo pavyzdžiai ir sprendimai
- Atskirti projektai atskiruose kataloguose (quiz-app, įvairūs pamokų projektai)
- Vertimų sistema su GitHub Actions (co-op-translator)
- Dokumentacija pateikiama per Docsify ir galima kaip PDF
- Mokomoji saugykla su pamokų struktūra
- Kiekvienos pamokos aplanke yra README, kodo pavyzdžiai ir sprendimai
- Atskiri savarankiški projektai atskiruose kataloguose (quiz-app, įvairūs pamokų projektai)
- Vertimo sistema per GitHub Actions (co-op-translator)
- Dokumentacija pateikiama per Docsify ir prieinama PDF formatu
## Nustatymo komandos
## Parengimo komandos
Ši saugykla skirta pirmiausia mokymuisi. Dirbant su konkrečiais projektais:
Ši saugykla skirta daugiausia mokomosios medžiagos naudojimui. Dirbant su konkrečiais projektais:
### Pagrindinės saugyklos nustatymas
### Pagrindinės saugyklos parengimas
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### Quiz App nustatymas (Vue 3 + Vite)
### Quiz App parengimas (Vue 3 + Vite)
```bash
cd quiz-app
npm install
npm run dev # Paleisti kūrimo serverį
npm run build # Sukurti gamybai
npm run build # Kurti produkcijai
npm run lint # Vykdyti ESLint
```
@ -51,12 +51,12 @@ npm run lint # Vykdyti ESLint
npm run format # Formatuoti su Prettier
```
### Naršyklės plėtinių projektai
### Naršyklės plėtinio projektai
```bash
cd 5-browser-extension/solution
npm install
# Vadovaukitės naršyklės konkrečiais plėtinių įkėlimo nurodymais
# Vadovaukitės naršyklės specifinėmis plėtinių įkėlimo instrukcijomis
```
### Kosminio žaidimo projektai
@ -67,7 +67,7 @@ npm install
# Atidarykite index.html naršyklėje arba naudokite Live Server
```
### Pokalbių projekto (Python backend) nustatymas
### Pokalbių projekto (Python backend) parengimas
```bash
cd 9-chat-project/solution/backend/python
@ -76,33 +76,33 @@ pip install openai
python api.py
```
## Vystymo darbo eiga
## Gamybos eiga
### Turinį prisidedantiems
### Turinio prisidėjėjams
1. **Fork'inkite saugyklą** į savo GitHub paskyrą
2. **Klonuokite savo fork'ą** vietoje
1. **Sukurkite forką** savo GitHub paskyroje
2. **Klonuokite forką** vietoje
3. **Sukurkite naują šaką** savo pakeitimams
4. Keiskite pamokų turinį arba kodo pavyzdžius
5. Testuokite kodo pakeitimus atitinkamuose projekto kataloguose
6. Pateikite pull request pagal kontributavimo taisykles
4. Redaguokite pamokų turinį arba kodo pavyzdžius
5. Išbandykite bet kokius kodo pakeitimus atitinkamuose projekto kataloguose
6. Pateikite pull request pagal prisidėjimo gaires
### Mokiniams
1. Fork'inkite arba klonuokite saugyklą
2. Sekite per pamokų katalogus iš eilės
1. Sukurkite forką arba klonuokite saugyklą
2. Eikite per pamokų katalogus paeiliui
3. Skaitykite kiekvienos pamokos README failus
4. Užbaikite priešpamokos testus adresu https://ff-quizzes.netlify.app/web/
5. Dirbkite su kodo pavyzdžiais pamokų kataloguose
4. Atlikite priešpamokinius testus https://ff-quizzes.netlify.app/web/
5. Dirbkite su kodo pavyzdžiais pamokų aplankuose
6. Atlikite užduotis ir iššūkius
7. Laikykite popamokos testus
7. Atlikite po pamokos testus
### Gyvas vystymas
- **Dokumentacija**: Paleiskite `docsify serve` pagrindiniame kataloge (3000 portas)
- **Quiz App**: Paleiskite `npm run dev` quiz-app kataloge
- **Projektai**: Naudokite VS Code Live Server plėtinį HTML projektams
- **API projektai**: Paleiskite `npm start` atitinkamuose API kataloguose
- **Dokumentacija**: paleiskite `docsify serve` šakniniame kataloge (prievadas 3000)
- **Quiz App**: paleiskite `npm run dev` quiz-app kataloge
- **Projektai**: naudokite VS Code Live Server plėtinį HTML projektams
- **API projektai**: paleiskite `npm start` atitinkamuose API kataloguose
## Testavimo instrukcijos
@ -111,7 +111,7 @@ python api.py
```bash
cd quiz-app
npm run lint # Patikrinkite kodo stiliaus problemas
npm run build # Patvirtinkite, kad statyba sėkminga
npm run build # Patikrinkite, ar kūrimas pavyksta
```
### Banko API testavimas
@ -119,164 +119,164 @@ npm run build # Patvirtinkite, kad statyba sėkminga
```bash
cd 7-bank-project/api
npm run lint # Patikrinkite kodo stiliaus problemas
node server.js # Patikrinkite, ar serveris paleidžiamas be klaidų
node server.js # Patikrinkite, ar serveris pradeda veikti be klaidų
```
### Bendras testavimo metodas
- Tai yra mokomoji saugykla be išsamių automatinių testų
- Rankinis testavimas apima:
- Kodo pavyzdžiai veikia be klaidų
- Dokumentacijos nuorodos veikia tinkamai
- Projektų kompiliacijos baigiamos sėkmingai
- Pavyzdžiai atitinka gerąsias praktikas
- Tai mokomoji saugykla be išsamių automatinių testų
- Rankinis testavimas orientuotas į:
- Kodo pavyzdžių veikimui be klaidų
- Dokumentacijos nuorodų veikimą
- Projektų sėkmingą surinkimą
- Pavyzdžių atitikimą geriausioms praktikoms
### Patikrinimai prieš pateikiant
### Prieš pateikiant užklausą atlikti patikrinimai
- Paleiskite `npm run lint` kataloguose su package.json
- Patikrinkite, ar markdown nuorodos yra galiojančios
- Testuokite kodo pavyzdžius naršyklėje arba Node.js
- Patikrinkite, ar markdown nuorodos galioja
- Išbandykite kodo pavyzdžius naršyklėje arba Node.js aplinkoje
- Įsitikinkite, kad vertimai išlaiko tinkamą struktūrą
## Kodo stiliaus gairės
### JavaScript
- Naudokite modernią ES6+ sintaksę
- Laikykitės standartinių ESLint konfigūracijų projektuose
- Naudokite šiuolaikinę ES6+ sintaksę
- Laikykitės standartinių ESLint konfigūracijų, pateiktų projektuose
- Naudokite prasmingus kintamųjų ir funkcijų pavadinimus mokymosi aiškumui
- Rašykite komentarus, paaiškinančius koncepcijas mokiniams
- Formatuokite naudodami Prettier, kur jis yra nustatytas
- Pridėkite komentarų, paaiškinančių sąvokas mokiniams
- Formatuokite naudodami Prettier ten, kur sukonfigūruota
### HTML/CSS
- Semantiniai HTML5 elementai
- Semantiški HTML5 elementai
- Reaguojančio dizaino principai
- Aiškios klasių pavadinimų konvencijos
- Aiškios klasių vardų konvencijos
- Komentarai, paaiškinantys CSS technikas mokiniams
### Python
- Laikytis PEP 8 stiliaus gairių
- PEP 8 stiliaus gairės
- Aiškūs mokomieji kodo pavyzdžiai
- Naudokite tipų užuominas ten, kur tai padeda mokantis
- Tipų anotacijos, kur naudingos mokymuisi
### Markdown dokumentacija
- Aiški antraščių hierarchija
- Kodo blokai nurodant kalbą
- Nuorodos į papildomus šaltinius
- Ekrano nuotraukos ir vaizdai `images/` kataloguose
- Alternatyvus tekstas vaizdams dėl prieinamumo
- Kodo blokai su kalbos nurodymu
- Nuorodos į papildomus išteklius
- Ekrano nuotraukos ir paveikslėliai `images/` kataloguose
- Alt tekstai paveikslėliams dėl prieinamumo
### Failų organizavimas
- Pamokos numeruojamos iš eilės (1-getting-started-lessons, 2-js-basics ir kt.)
- Kiekviename projekte yra `solution/` ir dažnai `start/` arba `your-work/` katalogai
- Vaizdai saugomi pamokai skirtuose `images/` aplankuose
- Vertimai saugomi `translations/{language-code}/` struktūroje
- Pamokos sunumeruotos paeiliui (1-getting-started-lessons, 2-js-basics ir kt.)
- Kiekvienas projektas turi `solution/` ir dažnai `start/` arba `your-work/` katalogus
- Paveikslėliai saugomi pamokų specifiniuose `images/` aplankuose
- Vertimai kataloguose `translations/{language-code}/`
## Konstravimas ir diegimas
## Surinkimas ir diegimas
### Quiz App diegimas (Azure Static Web Apps)
quiz-app yra sukonfigūruotas Azure Static Web Apps diegimui:
quiz-app sukonfigūruotas Azure Static Web Apps diegimui:
```bash
cd quiz-app
npm run build # Sukuria dist/ aplanką
# Diegia per GitHub Actions darbo eigą į main pusę stumiant
# Diegia per GitHub Actions darbo eigą, paleistą po commit į main šaką
```
Azure Static Web Apps konfigūracija:
- **Taikomosios programos vieta**: `/quiz-app`
- **Programos vieta**: `/quiz-app`
- **Išvesties vieta**: `dist`
- **Darbo eiga**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### PDF dokumentacijos generavimas
### Dokumentacijos PDF generavimas
```bash
npm install # Įdiekite docsify-to-pdf
npm run convert # Generuoti PDF iš dokumentų
npm run convert # Sugeneruokite PDF iš dokumentų
```
### Docsify dokumentacija
```bash
npm install -g docsify-cli # Įdiekite Docsify globaliai
docsify serve # Pateikite tarnybą adresu localhost:3000
docsify serve # Aptarnauti adresu localhost:3000
```
### Projektams skirtas konstravimas
### Projektams specifiniai surinkimai
Kiekvienas projekto katalogas gali turėti savo konstravimo procesą:
- Vue projektai: `npm run build` sukuria produkcinės versijos paketus
- Statiniai projektai: be konstravimo žingsnio, failai talpinami tiesiogiai
Kiekvienas projekto katalogas gali turėti savą surinkimo procesą:
- Vue projektai: `npm run build` sukuria gamybos paketus
- Statiški projektai: Nėra surinkimo žingsnio, failai aptarnaujami tiesiogiai
## Pull Request gairės
### Antraštės formatas
### Pavadinimų formatas
Naudokite aiškias, apibūdinančias antraštes, nurodančias pokyčių sritį:
Naudokite aiškius aprašomuosius pavadinimus, nurodančius pakeitimo sritį:
- `[Quiz-app] Pridėti naują testą pamokai X`
- `[Lesson-3] Pataisyti rašybos klaidą terrarium projekte`
- `[Translation] Pridėti ispanų vertimą 5 pamokai`
- `[Docs] Atnaujinti nustatymo instrukcijas`
- `[Lesson-3] Pataisyti klaidą terariumo projekte`
- `[Translation] Pridėti ispanų vertimą 5-ajai pamokai`
- `[Docs] Atnaujinti parengimo instrukcijas`
### Būtinos patikros
### Privalomi patikrinimai
Prieš pateikiant PR:
1. **Kodo kokybė**:
- Paleiskite `npm run lint` atitinkamuose projekto kataloguose
- Ištaisykite visas lint klaidas ir įspėjimus
- Paleiskite `npm run lint` paveiktuose projekto kataloguose
- Ištaisykite visus lint klaidų ir įspėjimų
2. **Konstravimo tikrinimas**:
2. **Surinkimo patikra**:
- Jei taikoma, paleiskite `npm run build`
- Užtikrinkite, kad konstravimo metu nėra klaidų
- Užtikrinkite, kad nėra surinkimo klaidų
3. **Nuorodų patikra**:
3. **Nuorodų validacija**:
- Patikrinkite visas markdown nuorodas
- Patvirtinkite, kad vaizdų nuorodos veikia
- Pasitikrinkite paveikslėlių nuorodų veikimą
4. **Turinio peržiūra**:
- Tikrinkite rašybą ir gramatiką
- Įsitikinkite, kad kodo pavyzdžiai yra teisingi ir mokomieji
- Patikrinkite, kad vertimai išlaiko pradinę reikš
- Patikrinkite rašybą ir gramatiką
- Užtikrinkite, kad kodo pavyzdžiai yra teisingi ir mokomieji
- Patikrinkite, ar vertimai atitinka originalią pras
### Indėlio reikalavimai
### Prisidėjimo reikalavimai
- Sutinkate su Microsoft CLA (automatinė patikra pirmame PR)
- Laikykitės [Microsoft Open Source elgesio taisyklių](https://opensource.microsoft.com/codeofconduct/)
- Žr. [CONTRIBUTING.md](./CONTRIBUTING.md) su išsamiais gairėmis
- Nurodykite problemos numerius PR aprašyme, jei taikoma
- Sutikite su Microsoft CLA (automatinis patikrinimas pirmame PR)
- Laikykitės [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Žiūrėkite [CONTRIBUTING.md](./CONTRIBUTING.md) detalias gaires
- Nurodykite problemų numerius PR aprašyme, jei taikoma
### Peržiūros procesas
- PR peržiūri palaikytojai ir bendruomenė
- Prioritetas mokymosi aiškumui
- Kodo pavyzdžiai turi atitikti dabartines gerąsias praktikas
- PR peržiūri prižiūrėtojai ir bendruomenė
- Prioritetas suteikiamas mokymo aiškumui
- Kodo pavyzdžiai turi atitikti dabartines geriausias praktikas
- Vertimai peržiūrimi dėl tikslumo ir kultūrinio atitikimo
## Vertimų sistema
## Vertimo sistema
### Automatinis vertimas
### Automatizuotas vertimas
- Naudojamos GitHub Actions su co-op-translator darbo eiga
- Naudoja GitHub Actions su co-op-translator darbo eiga
- Automatiškai verčia į daugiau nei 50 kalbų
- Šaltinio failai pagrindiniuose kataloguose
- Išversti failai saugomi `translations/{language-code}/` kataloguose
- Išversti failai kataloguose `translations/{language-code}/`
### Rankinių vertimo patobulinimų pridėjimas
1. Suraskite failą `translations/{language-code}/`
2. Atlikite patobulinimus išlaikydami struktūrą
1. Suraskite failą kataloge `translations/{language-code}/`
2. Atlikite patobulinimus išlaikant struktūrą
3. Įsitikinkite, kad kodo pavyzdžiai lieka veikiantys
4. Testuokite lokalizuotą testų turinį
4. Išbandykite lokalizuotą testų turinį
### Vertimų meta duomenys
### Vertimo metaduomenys
Išversti failai turi meta duomenų antraštę:
Išversti failai turi metaduomenų antraštę:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -293,100 +293,100 @@ CO_OP_TRANSLATOR_METADATA:
### Dažnos problemos
**Quiz app nepaleidžiamas**:
**Quiz aplikacija nesikrauna**:
- Patikrinkite Node.js versiją (rekomenduojama v14+)
- Ištrinkite `node_modules` ir `package-lock.json`, paleiskite `npm install` iš naujo
- Patikrinkite prievadų konfliktus (numatytasis: Vite naudoja 5173 portą)
- Patikrinkite prievado konfliktus (pagal nutylėjimą Vite naudoja 5173 prievadą)
**API serveris nepaleidžiamas**:
- Įsitikinkite, kad Node.js versija yra pakankama (node >=10)
- Patikrinkite ar prievadas neužimtas
**API serveris nesikrauna**:
- Įsitikinkite, kad Node.js versija atitinka reikalavimus (node >=10)
- Patikrinkite, ar prievadas nėra užimtas
- Įsitikinkite, kad visos priklausomybės įdiegtos su `npm install`
**Naršyklės plėtinys nesikrauna**:
- Patikrinkite, ar manifest.json yra tinkamai suformatuotas
- Patikrinkite naršyklės konsolę dėl klaidų
- Sekite naršyklės specifines plėtinio diegimo instrukcijas
- Peržiūrėkite naršyklės konsolę klaidoms
- Sekite naršyklės plėtinių įdiegimo instrukcijas
**Python pokalbių projekto problemos**:
- Įdiekite OpenAI paketą: `pip install openai`
- Įsitikinkite, kad GITHUB_TOKEN aplinkos kintamasis yra nustatytas
- Patikrinkite prieigos leidimus GitHub modeliams
- Įsitikinkite, kad GITHUB_TOKEN aplinkos kintamasis nustatytas
- Patikrinkite GitHub modelių prieigos leidimus
**Docsify nepateikia dokumentacijos**:
**Docsify neaptarnauja dokumentų**:
- Įdiekite docsify-cli globaliai: `npm install -g docsify-cli`
- Paleiskite iš saugyklos šakninio katalogo
- Įsitikinkite, kad `docs/_sidebar.md` egzistuoja
- Paleiskite iš saugyklos šaknies katalogo
- Įsitikinkite, kad egzistuoja `docs/_sidebar.md`
### Vystymo aplinkos patarimai
- Naudokite VS Code su Live Server plėtiniu HTML projektams
- Diekite ESLint ir Prettier plėtinius vienodam formatavimui
- Naudokitės naršyklės DevTools JavaScript derinimui
- Įdiekite ESLint ir Prettier plėtinius nuolatiniam formatavimui
- Naudokite naršyklės kūrėjų įrankius JavaScript derinimui
- Vue projektams įdiekite Vue DevTools naršyklės plėtinį
### Veikimo efektyvumo aspektai
- Daug išverstų failų (50+ kalbų) reiškia didelį pilną klonavimą
- Naudokite "shallow clone", jei dirbate tik su turiniu: `git clone --depth 1`
- Išskirkite vertimus paieškose dirbdami su anglų turiniu
- Konstravimo procesai gali būti lėti pirmą kartą (npm install, Vite build)
- Daug išverstų failų (50+ kalbų) reiškia didelius pilnus klonus
- Naudokite seklų klonavimą, jei dirbate tik su turiniu: `git clone --depth 1`
- Išskirkite vertimus iš paieškos, dirbant su anglų turiniu
- Surinkimo procesai gali būti lėti pirmą kartą (npm install, Vite build)
## Saugumo aspektai
### Aplinkos kintamieji
- API raktai niekada neturėtų būti įsipareigoti į repositoriją
- API raktai niekada neturėtų būti įtraukti į saugyklą
- Naudokite `.env` failus (jau įtrauktus į `.gitignore`)
- Dokumentuokite reikiamus aplinkos kintamuosius projektų README
- Dokumentuokite reikiamus aplinkos kintamuosius projekto README
### Python projektai
- Naudokite virtualias aplinkas: `python -m venv venv`
- Laikykite priklausomybes atnaujintas
- GitHub žetonai turi turėti minimalų reikiamą leidimą
- GitHub tokenai turėtų turėti tik minimalias reikalingas teises
### GitHub modelių prieiga
- Reikia asmeninių prieigos žetonų (PAT) GitHub modeliams
- Žetonus laikykite kaip aplinkos kintamuosius
- Niekada neįsipareigokite žetonų ar prisijungimų
- Asmeniniai prieigos tokenai (PAT) reikalingi GitHub modeliams
- Tokenai turi būti saugomi kaip aplinkos kintamieji
- Niekada neskelbkite tokenų ar prisijungimo duomenų
## Papildomos pastabos
### Tikslinė auditorija
- Visiškai pradedantieji interneto kūrime
- Studentai ir savimokos siekiantys asmenys
- Mokytojai, naudojantys mokymo programą klasėse
- Turinys sukurtas prieinamumui ir žingsniniam įgūdžių lavinimui
- Studentai ir savarankiškai mokosi
- Mokytojai, naudojantys programą klasėse
- Turinio dizainas orientuotas į prieinamumą ir laipsnišką įgūdžių įgijimą
### Mokomoji filosofija
### Mokymosi filosofija
- Mokymasis per projektus
- Projektinis mokymosi metodas
- Dažni žinių patikrinimai (testai)
- Praktiniai kodavimo pratimai
- Realaus pasaulio taikymo pavyzdžiai
- Akcentas ant pagrindų prieš perėjimą prie karkasų
- Praktiniai programavimo užsiėmimai
- Tikro gyvenimo pritaikymo pavyzdžiai
- Fokusas į pagrindus prieš frameworkus
### Saugyklos priežiūra
- Aktyvi mokinių ir prisidėjusių bendruomenė
- Aktyvi mokinių ir prisidėjėjų bendruomenė
- Reguliarūs priklausomybių ir turinio atnaujinimai
- Problemos ir diskusijos stebimos palaikytojų
- Vertimų atnaujinimai automatiniai per GitHub Actions
- Problemos ir diskusijos prižiūrimos prižiūrėtojų
- Vertimų atnaujinimai automatizuoti per GitHub Actions
### Susiję šaltiniai
### Susiję ištekliai
- [Microsoft Learn moduliai](https://docs.microsoft.com/learn/)
- [Student Hub resursai](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) rekomenduojamas mokiniams
- Papildomi kursai: Generative AI, Duomenų mokslas, ML, IoT mokymo programos prieinamos
- [Studentų centras](https://docs.microsoft.com/learn/student-hub/)
- Rekomenduojama naudoti [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot)
- Papildomi kursai: generatyvioji DI, duomenų mokslas, ML, IoT programos
### Darbas su konkrečiais projektais
Išsamias instrukcijas apie atskirus projektus žr. README failuose:
- `quiz-app/README.md` - Vue 3 testų taikomoji programa
Išsamios instrukcijos apie atskirus projektus pateiktos README failuose:
- `quiz-app/README.md` - Vue 3 testų programa
- `7-bank-project/README.md` - Banko programa su autentifikacija
- `5-browser-extension/README.md` - Naršyklės plėtinių vystymas
- `6-space-game/README.md` - Canvas pagrindu sukurtas žaidimas
@ -394,15 +394,15 @@ Išsamias instrukcijas apie atskirus projektus žr. README failuose:
### Monorepo struktūra
Nors tai nėra tradicinis monorepo, ši saugykla talpina kelis nepriklausomus projektus:
Nors tai nėra tradicinis monorepo, ši saugykla turi kelis nepriklausomus projektus:
- Kiekviena pamoka yra savarankiška
- Projektai nesidalina priklausomybėmis
- Dirbkite su atskirais projektais nepaveikdami kitų
- Klonuokite visą repositoriją, kad gautumėte pilną mokymo programą
- Projektai neturi bendrų priklausomybių
- Galima dirbti su atskirais projektais neįtakojant kitų
- Klonuokite visą saugyklą pilnai programos patirčiai gauti
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Atsakomybės atsisakymas**:
Šis dokumentas buvo išverstas naudojant dirbtinio intelekto vertimo paslaugą [Co-op Translator](https://github.com/Azure/co-op-translator). Nors siekiame tikslumo, prašome atkreipti dėmesį, kad automatiniai vertimai gali turėti klaidų ar netikslumų. Originalus dokumentas jo gimtąja kalba laikomas autoritetingu šaltiniu. Svarbiai informacijai rekomenduojama pasitelkti profesionalų žmogaus vertimą. Mes neatsakome už bet kokius nesusipratimus ar neteisingus supratimus, kylančius dėl šio vertimo naudojimo.
**Atsakomybės apribojimas**:
Šis dokumentas buvo išverstas naudojant dirbtinio intelekto vertimo paslaugą [Co-op Translator](https://github.com/Azure/co-op-translator). Nors siekiame tikslumo, atkreipkite dėmesį, kad automatizuoti vertimai gali turėti klaidų ar netikslumų. Originalus dokumentas gimtąja kalba laikomas autoritetingu šaltiniu. Kritinei informacijai rekomenduojama naudoti profesionalų žmogaus atliktą vertimą. Mes neatsakome už bet kokius nesusipratimus ar klaidingus aiškinimus, kilusius dėl šio vertimo naudojimo.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-02-06T12:09:08+00:00",
"translation_date": "2026-02-06T13:30:52+00:00",
"source_file": "AGENTS.md",
"language_code": "ta"
},

@ -1,70 +1,70 @@
# AGENTS.md
## திட்டம் கண்ணோட்டம்
## Project Overview
இது புதியவர்களுக்கு வலை வளர்ச்சியின் அடிப்படைகளை கற்பிக்க ஒரு கல்விச் பாடத்திட்ட சேமிப்பகமாகும். இந்த பாடத்திட்டம் Microsoft Cloud Advocates ஆகியோர் உருவாக்கிய முழுமையான 12-வாரம் நீண்ட பாடநெறி, இது JavaScript, CSS மற்றும் HTML ஆகியவற்றில் 24 நடைமுறை பாடங்கள் கொண்டுள்ளது.
இது ஆரம்பத்திற்கு வலை மேம்பாட்டின் அடிப்படைகளை கற்பிப்பதற்கான கல்வி பாடத்திட்டக் களஞ்சியம். இந்த பாடத்திட்டம் Microsoft Cloud Advocates ஐயால் உருவாக்கப்பட்ட முழுமையான 12 வார பாடநெறி ஆகும், இதில் JavaScript, CSS மற்றும் HTML ஆகியவற்றை உள்ளடக்கிய 24 கைப்பயிற்சி வகுப்புகள் உள்ளன.
### முக்கிய கூறுகள்
### Key Components
- **கல்வி உள்ளடக்கம்**: திட்ட அடிப்படையிலான தொகுதிகளாக அமைந்த 24 கட்டமைக்கப்பட்ட பாடங்கள்
- **நடைமுறைத் திட்டங்கள்**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, மற்றும் AI Chat Assistant
- **இணையவழி வினாடிகளைச் சோதனைகள்**: ஒவ்வொன்றிலும் 3 கேள்விகளுடன் 48 வினாடி சோதனைகள் (பாடத்திற்கு முந்தைய/பிறகு மதிப்பீடுகள்)
- **ன்மொழி ஆதரவு**: GitHub Actions மூலம் 50+ மொழிகளுக்கான தானியங்கி மொழிபெயர்ப்பு
- **தொழில்நுட்பங்கள்**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI திட்டங்களுக்கான)
- **கல்வி உள்ளடக்கம்**: திட்ட அடிப்படையிலான தொகுதிகளாக அமைக்கப்பட்ட 24 கட்டமைக்கப்பட்ட வகுப்புகள்
- **பயிற்சி திட்டங்கள்**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, மற்றும் AI Chat Assistant
- **திறமையான வினாக்கள்**: ஒவ்வொரு வகுப்பிற்கும் முன்ன அமைச்சர்/பின் கற்றல் மதிப்பாய்வாக 3 கேள்விகளைக் கொண்ட 48 வினாடி விசாரணைகள்
- **மொழி ஆதரவு**: GitHub Actions மூலம் 50+ மொழிகளுக்கான தானாக மொழிபெயர்ப்பு
- **தொழில்நுட்பங்கள்**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (AI திட்டங்களுக்க)
### கட்டமைப்பு
### Architecture
- பாடநெறி அடிப்படையிலான அமைப்புடன் கல்வி சேமிப்பகம்
- ஒவ்வொரு பாடத்திற்குமான கோப்பு அடைவுகளில் README, குறியீடு எடுத்துக்காட்டுகள் மற்றும் தீர்வுகள் உள்ளன
- தனித்தன்மையுள்ள திட்டங்கள் தனி அடைவுகளில் உள்ளன (quiz-app, பல பாட திட்டங்கள்)
- GitHub Actions (co-op-translator) மூலம் மொழிபெயர்ப்பு அமைப்பு
- Docsify மூலம் ஆவணங்கள் வழங்கப்பட்டு PDF வடிவில் கிடைக்கிறது
- வகுப்புகளின் அடிப்படையில் அமைக்கப்பட்ட கல்வி களஞ்சியம்
- ஒவ்வொரு வகுப்பு கோப்பகத்திலும் README, குறியீடு எடுத்துக்காட்டுகள் மற்றும் தீர்வுகள் உள்ளன
- quiz-app மற்றும் பல்வேறு வகுப்பு திட்டங்களை தனி கோப்பகங்களில் வைத்தல்
- GitHub Actions (co-op-translator) மூலம் மொழிபெயர்ப்பு முறைமை
- Docsify மூலம் வழங்கப்பட்ட ஆவணங்கள் PDF ஆகவும் கிடைக்கின்றன
## அமைப்பு கட்டளைகள்
## Setup Commands
இந்த சேமிப்பகம் முதன்மையாக கல்வி உள்ளடக்கம் பயன்படுத்தும் நோக்கத்திற்காக உள்ளது. குறிப்பிட்ட திட்டங்களில் பணியாற்ற:
இந்த களஞ்சியம் பெரும்பாலும் கல்வி உள்ளடக்கம் பயன்பாட்டிற்காக இருக்கிறது. குறிப்பிட்ட திட்டங்களுடன் பணியாற்றுவதற்கு:
### பிரதான சேமிப்பகம் அமைப்பு
### Main Repository Setup
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
cd Web-Dev-For-Beginners
```
### Quiz App அமைப்பு (Vue 3 + Vite)
### Quiz App Setup (Vue 3 + Vite)
```bash
cd quiz-app
npm install
npm run dev # அபிவிருத்தி சேவையகத்தைத் தொடங்கு
npm run dev # மேம்பாட்டு சேவையகத்தை தொடங்கு
npm run build # உற்பத்திக்கான கட்டுமானம்
npm run lint # ESLint ஐ இயக்குக
npm run lint # ESLintஐ இயக்கவும்
```
### வங்கி திட்ட API (Node.js + Express)
### Bank Project API (Node.js + Express)
```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 உடன் வடிவமைக்கவும்
```
### Browser Extension திட்டங்கள்
### Browser Extension Projects
```bash
cd 5-browser-extension/solution
npm install
# உலாவி-சந்தான நீட்டிப்பு ஏற்றும் குறிப்புகளை பின்பற்றவும்
# உலாவி-சார்ந்த நீட்டிப்பு ஏற்றும் வழிமுறைகளை பின்பற்று
```
### Space Game திட்டங்கள்
### Space Game Projects
```bash
cd 6-space-game/solution
npm install
# index.html ஐ உலாவியில் திறக்கவும் அல்லது Live Server ஐ பயன்படுத்தவும்
# browserல் index.html ஐ திறக்கவும் அல்லது Live Server ஐ பயன்படுத்தவும்
```
### Chat Project (Python Backend)
@ -72,211 +72,211 @@ npm install
```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 ஐ **கோப்புறையில் கிளோன் செய்யவும்**
3. உங்கள் மாற்றங்களுக்கு புதிய கிளைக் உருவாக்கவும்
4. பாட உள்ளடக்கம் அல்லது குறியீடு எடுத்துக்காட்டுகளில் மாற்றங்கள் செய்யவும்
5. பொருத்தமான திட்ட அடைவுகளில் குறியீடு மாற்றங்களை சோதனை செய்யவும்
6. பங்கேற்புத் தளம் வழிகாட்டிக் குறிப்புகளை பின்பற்றி pull requests சமர்ப்பிக்கவும்
1. **உங்கள் GitHub கணக்கில் களஞ்சியத்தை Fork செய்யவும்**
2. **உங்கள் fork ஐ இடதுசாரி கிளோன் செய்யவும்**
3. **மாற்றங்களுக்கு புதிய கிளையை உருவாக்கவும்**
4. பாடத் தொகுப்புகள் அல்லது குறியீடு எடுத்துக்காட்டுகளை மாற்றவும்
5. தொடர்புடைய திட்ட கோப்பகங்களில் குறியீடு மாற்றங்களைச் சோதிக்கவும்
6. பங்களிப்பு வழிகாட்டுதல்களை பின்பற்றி pull request சமர்ப்பிக்கவும்
### கற்பவர்கள் குடி
### For Learners
1. சேமிப்பகத்தை fork அல்லது clone செய்யவும்
2. பாட அடைவுகளை தொடர் முறையில் செல்லவும்
3. ஒவ்வொரு பாடத்தின் README கோப்புகளை படிக்கவும்
4. https://ff-quizzes.netlify.app/web/ இல் பாடத்திற்கு முந்தைய வினாடி பரீட்சைகளை முடிக்கவும்
5. பாட அடைவுகளில் குறியீடு எடுத்துக்காட்டுகளுக்கு வேலை செய்யவும்
6. பணிகள் மற்றும் சவால்களை முடிக்கவும்
7. பாடத்திற்கு பிறகு வினாடி பரீட்சைகள் எடுக்கவும்
1. களஞ்சியத்தை fork அல்லது clone செய்யவும்
2. வகுப்பு கோப்பகங்களில் தொடர் முறையில் செல்லவும்
3. ஒவ்வொரு வகுப்பிற்குமான README கோப்புகளைப் படிக்கவும்
4. முன்-வகுப்பு வினாடி விசாரணைகளை https://ff-quizzes.netlify.app/web/ இல் முடிக்கவும்
5. வகுப்பு கோப்பகங்களில் குறியீடு எடுத்துக்காட்டுகளைச் செயல்படுத்தவும்
6. பணிகள் மற்றும் சவால்களை முடிக்கவும்
7. பின்வகுப்பு வினாடி விசாரணைகளை இடையே முடிக்கவும்
### நேரடி அபிவிருத்தி
### Live Development
- **ஆவணங்கள்**: ரூட் வழியில் `docsify serve` ஐ ஓட்டவும் (போர்ட் 3000)
- **Quiz App**: quiz-app அடைவில் `npm run dev` ஓட்டவும்
- **திட்டங்கள்**: HTML திட்டங்களுக்கு VS Code Live Server விரிவுருவைப் பயன்படுத்தவும்
- **API திட்டங்கள்**: தொடர்புடைய API அடைவுகளில் `npm start` ஓட்டவும்
- **ஆவணங்கள்**: root இல் `docsify serve` இயக்கவும் (போர்டு 3000)
- **Quiz App**: quiz-app கோப்பகத்தில் `npm run dev` இயக்கவும்
- **திட்டங்கள்**: HTML திட்டங்களுக்கு VS Code Live Server கிளைன்டை பயன்படுத்தவும்
- **API திட்டங்கள்**: API கோப்பகங்களில் `npm start` இயக்கவும்
## சோதனைக்கான வழிமுறைகள்
## Testing Instructions
### Quiz App சோதனை
### Quiz App Testing
```bash
cd quiz-app
npm run lint # குறியீட்டு பாணி பிரச்சனைகள் உள்ளதா என சரிபார்க்கவும்
npm run build # கட்டுமானம் வெற்றிகரமாக நடக்கிறதா என உறுதிப்படுத்தவும்
npm run lint # குறியீட்டு பாணி பிரச்சினைகள் உள்ளதா என சோதிக்கவும்
npm run build # கட்டமைப்பு வெற்றி பெறுமா என உறுதிப்படுத்தவும்
```
### வங்கி API சோதனை
### Bank API Testing
```bash
cd 7-bank-project/api
npm run lint # குறியீட்டு பாணி பிரச்சனைகளை சரிபார்க்கவும
node server.js # சேவையக பிழைகளின்றி துவங்குவதை உறுதிப்படுத்தவும்
npm run lint # குறியீடு στιலைப் பிழைகளைச் சரிபார
node server.js # சேவையகம் பிழைகள் இல்லாமல் துவங்குகிறதா என்பதைக் கையேர்த்து பார்க்கவும்
```
### பொது சோதனை முறைகள்
### General Testing Approach
- இது முழுமையான தானியங்கி சோதனைகளின்றி ஒரு கல்விச் சேமிப்பகம்
- கைமுறை சோதனைகள் கீழ்வருமாறு கவனம் செலுத்துகின்றன:
- குறியீடு எடுத்துக்காட்டுகள் பிழையின்றி இயங்க வேண்டும்
- ஆவணங்களில் இணைப்புகள் சரியாக வேலை செய்யவேண்டும்
- திட்ட கட்டமைப்புகள் வெற்றிகரமாகத் தீர்க்கப்பட வேண்டும்
- எடுத்துக்காட்டுகள் சிறந்த நடைமுறைகளை பின்பற்ற வேண்டும்
- இது முழுமையான தானாகச் சோதனை செய்யாத கல்வி களஞ்சியம்
- கைமுறை சோதனை கவனம் செலுத்தும் விஷயங்கள்:
- குறியீடு எடுத்துக்காட்டுகள் பிழையின்றி இயங்குதல்
- ஆவண LINK கள் சரியாக வேலை செய்வது
- திட்ட கட்டமைப்புகள் வெற்றிகரமாக நிறைவடைவது
- எடுத்துக்காட்டுகள் சிறந்த நடைமுறைகளை பின்பற்றுதல்
### சமர்ப்பிப்பிற்கு முன் பரிசோதனைகள்
### Pre-submission Checks
- package.json உடன் அடைவுகளில் `npm run lint` ஓடவும்
- மார்க்டவுன் இணைப்புகள் செல்லுபடியாக உள்ளனவா பரிசோதிக்கவும்
- குறியீடு எடுத்துக்காட்டுகளை உலாவி அல்லது Node.js இல் சோதிக்கவும்
- மொழிபெயர்ப்புகள் சரியான கட்டமைப்பை பராமரிக்கின்றனவா பாருங்கள்
- package.json உள்ள கோப்பகங்களில் `npm run lint` இயக்கவும்
- Markdown URL கள் செல்லுபடியானவை என்பதை சரிபார்க்கவும்
- குறியீடு எடுத்துக்காட்டுகளை browser அல்லது 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
- தெளிவான தலைப்பு வரிசை
- மொழி குறிப்பிடப்பட்ட குறியீடு கட்டங்கள்
- கூடுதல் வளங்களுக்கான இணைப்புகள்
- `images/` அடைவுகளில் திரைபடங்கள் மற்றும் புகைப்படங்கள்
- அணுகுதல் வசதிக்கான படங்களுக்கான Alt உரை
- தெளிவான தலைப்பு வரிசை
- மொழி தன்மையுடைய குறியீடு தொகுதிகள்
- கூடுதல் வளங்களைக் காட்டு LINK கள்
- `images/` கோப்பகங்களில் படங்கள் மற்றும் திரைகள்
- படங்களுக்கான Alt உரை
### கோப்பு அமைப்பு
### File Organization
- பாடங்கள் தொடர்ச்சியாக எண்கள் (1-getting-started-lessons, 2-js-basics, முதலியன)
- ஒவ்வொரு திட்டத்திற்கும் `solution/` மற்றும் பெரும்பாலும் `start/` அல்லது `your-work/` அடைவுகள் உள்ளன
- பாட அதிகாரமான `images/` அடைவுகளில் படங்கள் சேமிக்கப்படுகின்றன
- மொழிபெயர்ப்புகள் `translations/{language-code}/` கட்டமைப்பில் உள்ளன
- வகுப்புகள் தொடர் எண்களுடன் பெயரிடப்பட்டவை (1-getting-started-lessons, 2-js-basics, மற்றும் இதரன)
- ஒவ்வொரு திட்டத்திலும் `solution/` மற்றும் பொதுவாக `start/` அல்லது `your-work/` கோப்பகங்கள் உள்ளன
- படங்கள் வகுப்பு-சிப் `images/` கோப்பகங்களில் சேமிக்கப்படுகின்றன
- மொழிபெயர்ப்புகள் `translations/{language-code}/` கட்டமைப்பில் உள்ளன
## கட்டுமானம் மற்றும் வழங்கல்
## Build and Deployment
### Quiz App வழங்கல் (Azure Static Web Apps)
### 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 செயலிகள் வேலைப்பாட்டின் மூலம் வெளியிடுகிறது
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 இடம்**: `/quiz-app`
- **வெளியீட்டு இடம்**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### ஆவண PDF பின்வலயம் உருவாக்கல்
### Documentation PDF Generation
```bash
npm install # docsify-to-pdf ஐ நிறுவுக
npm run convert # docs இலிருந்து PDF உருவாக்குக
npm install # docsify-to-pdf ஐ நிறுவவும்
npm run convert # ஆவணங்களிலிருந்து PDF உருவாக்கவும்
```
### Docsify ஆவணங்கள்
### Docsify Documentation
```bash
npm install -g docsify-cli # Docsify-ஐ உலகளாவிய முறையில் நிறுவவும்
docsify serve # localhost:3000-ல் சேவை செய்யவும்
npm install -g docsify-cli # Docsifyஐ உலகளாவிய அளவில் நிறுவுக
docsify serve # localhost:3000 இல் சேவை செய்க
```
### திட்ட குறிப்பிட்ட கட்டமைப்புகள்
### Project-specific Builds
ஒவ்வொரு திட்ட அடைவுக்கும் தனித்த கட்டுமான செயல்முறை இருக்கலாம்:
- Vue திட்டங்கள்: `npm run build` மூலம் உற்பத்தி தொகுதிகள் உருவாகின்றன
- நிலையான திட்டங்கள்: கட்டுமான படி இல்லை, கோப்புகளை நேரடியாக வழங்கவும்
ஒவ்வொரு திட்டக் கோப்பகத்திற்கும் தனித்தனி கட்டமைப்பு நடைமுறைகள் இருக்கலாம்:
- Vue திட்டங்கள்: `npm run build` மூலம் தயாரிப்பு தொகுப்புகள் உருவாக்கப்படுகின்றன
- நிலையான திட்டங்கள்: எந்த கட்டமைப்பும் தேவையில்லை, கோப்புகளை நேரடியாக சேவை செய்வது
## Pull Request வழிகாட்டிகள்
## Pull Request Guidelines
### தலைப்பு வடிவமைப்பு
### Title Format
மாற்றப் பகுதிகளைக் காட்டும் தெளிவான விளக்க தலைப்புகளைப் பயன்படுத்தவும்:
- `[Quiz-app] பாடம் X க்கான புதிய வினாடி தேர்வு சேர்க்கவும்`
- `[Lesson-3] Terrarium திட்டத்தில் பிழை திருத்தம்`
- `[Translation] பாடம் 5 க்கான ஸ்பானிஷ் மொழிபெயர்ப்பு சேர்க்கவும்`
- `[Docs] அமைப்புத் தகவலை புதுப்பிக்கவும்`
மாற்றம் ரீதியான தெளிவான தலைப்புகளைப் பயன்படுத்தவும்:
- `[Quiz-app] Add new quiz for lesson X`
- `[Lesson-3] Fix typo in terrarium project`
- `[Translation] Add Spanish translation for lesson 5`
- `[Docs] Update setup instructions`
### தேவையான சோதனைகள்
### Required Checks
PR சமர்ப்பிப்பதற்கு முன்:
PR சமர்ப்பிப்பிற்கு முன்:
1. **குறியீடு தரம்**:
- பாதிப்படைந்த திட்ட அடைவுகளில் `npm run lint` ஓட்டவும்
- அனைத்து lint பிழைகள் மற்றும் எச்சரிக்கைகளை சரிசெய்யவும்
1. **குறியீடு தரம்**:
- பாதிப்படையப்பட்ட திட்டக் கோப்பகங்களில் `npm run lint` இயக்கவும்
- அனைத்து பிழைகள் மற்றும் எச்சரிக்கைகளை சரி செய்யவும்
2. **கட்டுமான சரிபார்ப்பு**:
- பொருந்தும் பட்சத்தில் `npm run build` ஓட்டவும்
- கட்டுமான பிழைகள் இல்லாமல் உறுதி செய்யவும்
2. **கட்டமைப்பு சரிபார்ப்பு**:
- பயன்படுமானால் `npm run build` இயக்கவும்
- கட்டமைப்பு பிழைகள் இல்லாய் உறுதிப்படுத்தவும்
3. **இணைப்பு சரிபார்ப்பு**:
- அனைத்து மார்க்டவுன் இணைப்புகளையும் சோதிக்கவும்
- பட தொடர்புகளைச் சரி பார்த்தல்
3. **Link சரிபார்ப்பு**:
- அனைத்து markdown LINKS ஐச் சோதிக்கவும்
- படங்கள் குறிப்பு வேலை செய்கிறது என்று பரிசோதிக்கவும்
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 விளக்கத்தில் தொடர்புடைய issue எண்களை குறிப்பிட்டு விடவும்
### ஆய்வுப் பணிகள்
### Review Process
- PR க்கள் பராமரிப்பாளர்களாலும் சமுதாயத்தாலும் மதிப்பாய்வு செய்யப்படுகின்றன
- கல்வி தெளிவு முக்கியமாக எடுத்துக்கொள்ளப்படுகிறது
- குறியீடு எடுத்துக்காட்டுகள் தற்போதைய சிறந்த நடைமுறைகளை பின்பற்ற வேண்டும்
- மொழிபெயர்ப்புகள் துல்லியமாகவும், கலாச்சாரத்திற்கு ஏற்பவையாகவும் இருக்க வேண்டும்
- PR கள் பராமரிப்பாளர்களாலும் சமுதாயத்தாலும் மதிப்பாய்வு செய்யப்படுகின்றன
- கல்வி தெளிவுக்கு முன்னுரிமை அளிக்கப்படுகிறது
- குறியீடு எடுத்துக்காட்டுகள் நவீன சிறந்த நடைமுறைகளை பின்பற்ற வேண்டும்
- மொழிபெயர்ப்புகள் துல்லியமும் பண்பட்ட உரியத்தன்மையும் கொண்டதாக இருக்க வேண்டும்
## மொழி மாற்ற அமைப்பு
## Translation System
### தானியங்கி மொழிபெயர்ப்பு
### Automated Translation
- GitHub Actions உடன் co-op-translator பணிச்சூழல் பயன்படுத்துகிறது
- 50+ மொழிகளுக்கு தானாகப் மொழிபெயர்க்கப்படுகிறது
- மூலக் கோப்புகள் பிரதான அடைவுகளில் உள்ளன
- மொழிபெயர்க்கப்பட்ட கோப்புகள் `translations/{language-code}/` அடைவுகளில் உள்ளன
- GitHub Actions உடன் co-op-translator workflow பயன்படுத்தப்படுகிறது
- 50+ மொழிகளில் தானாக மொழிபெயர்க்கிறது
- மூலக் கோப்புகள் முக்கிய கோப்பகங்களில் உள்ளன
- மொழிபெயர்க்கப்பட்ட கோப்புகள் `translations/{language-code}/` கோப்பகங்களில் உள்ளன
### கைமுறை மொழிபெயர்ப்பு மேம்பாடுகள் சேர்க்கல்
### Adding Manual Translation Improvements
1. `translations/{language-code}/` இல் கோப்பை கண்டறியவும்
2. கட்டமைப்பை பராமரித்துக்கொண்டு மேம்பாடுகளைச் செய்யவும்
3. குறியீடு எடுத்துக்காட்டுகள் செயல்படும் வகையில் இருக்க வேண்டும்
4. உள்ளூர் வினாடி பரீட்சை உள்ளடக்கம் சோதிக்கவும்
1. `translations/{language-code}/` இல் கோப்புகளை கண்டுபிடிக்கவும்
2. அமைப்பை பாதுகாப்பாக முறைப்படி மேம்படுத்தவும்
3. குறியீடு எடுத்துக்காட்டுகள் இயங்குவது உறுதிப்படுத்தவும்
4. உள்ளூர் வினாடி விசாரணை உள்ளடக்கம் (quiz content) இருந்தால் சோதிக்கவும்
### மொழிபெயர்ப்பு மெட்டாடேட்டா
### Translation Metadata
மொழிபெயர்க்கப்பட்ட கோப்புகளில் மெட்டாடேட்டா தலைப்பு உள்ளது:
மொழிபெயர்க்கப்பட்ட கோப்புகள் metadata தலைப்பைக் கொண்டிருக்கும்:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
-->
```
## பிழை கண்டறிதல் மற்றும் சிக்கல் தீர்வு
## Debugging and Troubleshooting
### பொதுவான பிரச்சினைகள்
### Common Issues
**Quiz app துவங்கவில்லை**:
- Node.js பதிப்பை சரிபார்க்கவம் (v14+ பரிந்துரைக்கப்படுகிறது)
- `node_modules` மற்றும் `package-lock.json` நீக்கி `npm install` மறுபடி ஓட்டவும்
- போர்ட் மோதல்கள் உள்ளதா பாருங்கள் (இயல்புநிலை: Vite போர்ட் 5173 பயன்படுத்துகிறது)
**Quiz app தொடங்காமல் விட்டால்**:
- 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 சரியான வடிவத்தில் உள்ளது என்பதை உறுதி செய்யவும்
- உலாவி கன்சோலில் பிழைகள் உள்ளதா பாருங்கள்
- உலாவி-தனித்துவப்பட்ட விரிவுரு நிறுவல் வழிகாட்டல்களை பின்பற்றவும்
**Browser extension ஏற்றப்படவில்லை என்றால்**:
- manifest.json சரியாக வடிவமைக்கப்பட்டதா செக் செய்யவும்
- browser console பிழைகளைப் பார்வையிடவும்
- browser-க்கு தனித்தனியான இணைப்பு நிறுவல் வழிமுறைகளை பின்பற்றவும்
**Python chat திட்ட பிரச்சினைகள்**:
- OpenAI தொகுப்பு நிறுவப்பட்டுள்ளதா: `pip install openai`
- GITHUB_TOKEN சுற்றுச்சூழல் மாறி செட்டாயிருக்கிறதா பாருங்கள்
- GitHub Models அணுகல் அனுமதிகளை சோதிக்கவும்
**Python chat project பிரச்சினைகள்**:
- OpenAI தொகுப்பு நிறுவப்பட்டதா: `pip install openai`
- GITHUB_TOKEN சூழல் மாறி அமைக்கப்பட்டிருக்கிறதா என்பதைக் சரிபார்க்கவும்
- GitHub Models அணுகல் அனுமதிகள் உள்ளனவா செக் செய்யவும்
**Docsify ஆவணம் வழங்கவில்லை**:
- docsify-cli ஐ உலகளாவியமாக நிறுவவும்: `npm install -g docsify-cli`
- சேமிப்பக ரூட் அடைவில் இருந்து ஓட்டவும்
- `docs/_sidebar.md` உள்ளதா பரிசோதிக்கவும்
**Docsify ஆவணங்கள் சேவை செய்யவில்லை என்றால்**:
- global ஆக docsify-cli நிறுவவும்: `npm install -g docsify-cli`
- களஞ்சியத்தின் root directory இல் இருந்து இயக்கவும்
- `docs/_sidebar.md` உள்ளது என்பதை உறுதிசெய்யவும்
### அபிவிருத்தி சுற்றுச்சூழல் குறிப்புகள்
### Development Environment Tips
- HTML திட்டங்களுக்கு VS Code Live Server விரிவுருவைக பயன்படுத்தவும்
- எழுத்து ஒற்றுமைக்காக ESLint மற்றும் Prettier விரிவுருக்களை நிறுவவும்
- JavaScript பிழைத்திருத்தத்திற்கான உலாவி DevTools ஐ பயன்படுத்தவும்
- Vue திட்டங்களுக்கு Vue DevTools உலாவி விரிவுருவை நிறுவவும்
- HTML திட்டங்களுக்கு VS Code Live Server விரிவாக்கத்தைப் பயன்படுத்தவும்
- ஒழுங்கான வடிவமைப்புக்கு ESLint மற்றும் Prettier விரிவாக்கங்களை நிறுவவும்
- JavaScript பிழைத்திருத்தத்திற்கு browser DevTools பயன்பாடு
- Vue திட்டங்களுக்கு Vue DevTools browser extension நிறுவவும்
### செயல்திறன் கருத்துக்கள்
### Performance Considerations
- மொழிபெயர்க்கப்பட்ட கோப்புகளின் அதிக எண்ணிக்கை (50+ மொழிகள்) அதிகமான பையில் பெரிதாக இருக்கும்
- உள்ளடக்கத்தில் மட்டுமே பணியாற்ற shallow clone பயன்படுத்தவும்: `git clone --depth 1`
- ஆங்கில உள்ளடக்க பணியாற்றும்போது மொழிபெயர்ப்புகளை தேடலிலிருந்து தவிர்க்கவும்
- முதல் ஓட்டத்தில் கட்டுமான செயல்முறைகள் மந்தமாக இருக்கலாம் (npm install, Vite build)
- 50+ மொழிகள் கொண்ட பெரிய அளவு மொழிபெயர்ப்புகளை உள்ளடக்கியதால் முழு clone பெரிதாக இருக்கும்
- உள்ளடக்கம் மட்டுமே பணியாற்றில், சிறிய clone (`git clone --depth 1`) பயன்படுத்தவும்
- ஆங்கில உள்ளடக்கத்தில் பணியாற்றும் போது மொழிபெயர்ப்புகளை தேடலில் இருந்து விலக்கு செய்யவும்
- முதல் முறையாக npm install, Vite கட்டமைப்பு என்றபோது கட்டமைப்பு சற்று மெதுவாக இருக்கலாம்
## பாதுகாப்பு கருத்துகள்
## Security Considerations
### சுற்றுச்சூழல் மாறிகள்
### Environment Variables
- API விசைகள் சேமிப்பகத்தில் ஒருபோதும் பதியப்படக் கூடாது
- `.env` கோப்புகளை பயன்படுத்தவும் (ஏற்கனவே `.gitignore` இல் உள்ளது)
- தேவையான சுற்றுச்சூழல் மாறிகள் திட்ட READMEல் ஆவணம் செய்யவும்
- API விசைகள் களஞ்சியத்தில் commit செய்யப்படக் கூடாது
- `.env` கோப்புகளை பயன்படுத்தவும் (இவை `.gitignore` இல் உள்ளன)
- தேவையான சூழல் மாறிகளை திட்ட READMEs இல் ஆவணப்படுத்தவும்
### Python திட்டங்கள்
### Python Projects
-மெய்நிகர் சூழல்களைப் பயன்படுத்தவும்: `python -m venv venv`
- சார்ந்த பொருட்களை இப்போதுபோல் மேம்படுத்தவும்
- GitHub டோக்கன்களுக்கு குறைந்தபட்ச அனுமதிகளை வழங்கவும்
- மெய்நிகர் சூழலைப் பயன்படுத்தவும்: `python -m venv venv`
- சார்புகளை புதுப்பித்து வைக்கவும்
- GitHub டோக்கன்களுக்கு குறைந்தபட்ச அனுமதிகள் தேவையா என கவனிக்கவும்
### GitHub Models அணுகல்
### GitHub Models Access
- GitHub Models க்கான தனிப்பட்ட அணுகல் டோக்கன்கள் (PAT) தேவையானவை
- டோக்கன்கள் சுற்றுச்சூழல் மாறிகள் ஆகச் சேமிக்கப்பட வேண்டும்
- ஒருபோதும் டோக்கன்கள் அல்லது ஆதாரங்களைக் கமிட் செய்யாதீர்கள்
- GitHub Models க்கான தனிப்பட்ட அனுமதி டோக்கன்கள் (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` - புலம் பொருத்த வண்ண கேம் அபிவிருத்தி
- `9-chat-project/README.md` - AI அரட்டை உதவியாளர் திட்டம்
தனித்தனி திட்டங்களுக்கு விரிவான வழிமுறைகளுககு, கீழ்காணும் README கோப்புகளைப் பார்க்கவும்:
- `quiz-app/README.md` - Vue 3 வினாடி விசாரணை பயன்பாடு
- `7-bank-project/README.md` - அங்கீகாரம் உடன் வங்கி பயன்பாடு
- `5-browser-extension/README.md` - Browser extension மேம்பாடு
- `6-space-game/README.md` - Canvas அடிப்படையிலான விளையாட்டு மேம்பாடு
- `9-chat-project/README.md` - AI அரட்டைக் உதவியாளர் திட்டம்
### மொனோரெபோ கட்டமைப்பு
### Monorepo Structure
இது பாரம்பரிய மொனோரெபோ அல்ல, பல தனித்தனிப் திட்டங்களை கொண்டுள்ளது:
- ஒவ்வொரு பாடமும் தனித்துள்ளதுமானது
- திட்டங்கள் சார்ந்த பொருட்கள் பகிர்ந்து கொள்ளப்படாது
- ஒருங்கிணைந்ததாக இல்லாமல் தனி தனி திட்டங்களில் பணியாற்றலாம்
- முழு பாடத்திட்ட அனுபவத்திற்காக முழுக் களஞ்சியத்தை கிளோன் செய்யலாம்
சாதாரண monorepo அல்லாதபோதும், இந்தக் களஞ்சியத்தில் பல தனி திட்டங்கள் உள்ளன:
- ஒவ்வொரு வகுப்பும் தனித்தன்மையுடையது
- திட்டங்கள் சார்புகளைப் பகிராது
- தனித்தனி திட்டங்களில் வேலைசெய்யும் போது மற்றவற்றுக்கு பாதிப்பில்லை
- முழு பாடத்திட்ட அனுபவத்திற்காக முழு களஞ்சியத்தை கிளோன் செய்யவும்
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**குறிப்புரை**:
இந்த ஆவணம் AI மொழிபெயர்ப்பு சேவை [Co-op Translator](https://github.com/Azure/co-op-translator) மூலம் மொழிபெயர்க்கப்பட்டுள்ளது. நாங்கள் துல்லியத்தைக் காத்திருக்கிறோம் என்றாலும், தானாக செய்யப்பட்ட மொழிபெயர்ப்புகளில் பிழைகள் அல்லது தவறுகள் இருக்க வாய்ப்பு உண்டு என்பதை தயவுசெய்து கவனத்தில் கொள்ளவும். மூல ஆவணம் அதன் தாய்மொழியில் அதிகாரபூர்வ ஆவணமாக கருதப்பட வேண்டும். முக்கியமான தகவல்களுக்கு, தொழில்முறை மனித மொழிபெயர்ப்பாளர் மூலம் மொழிபெயர்ப்ப செய்ய பரிந்துரைக்கப்படுகிறது. இந்த மொழிபெயர்ப்பின் பயன்பாட்டினால் ஏற்படும் எந்தவொரு தவறுதலும் அல்லது தவறான புரிதலுக்குமான பொறுப்பேற்க நாங்கள் முன்வரமாட்டோம்.
**பிரதிபஞ்சிகை**:
இந்த ஆவணம் [Co-op Translator](https://github.com/Azure/co-op-translator) எனும் செயற்கை நுண்ணறிவு மொழிபெயர்ப்பு சேவையால் மொழிபெயர்க்கப்பட்டுள்ளது. நாங்கள் துல்லியத்திற்காக முயன்றாலும், தானியங்கி மொழிபெயர்ப்புகளில் தவறுகள் அல்லது குறைகள் இருக்கலாம் என்பதைக் கவனத்தில் கொள்ளவும். அதன் சொந்த மொழியில் உள்ள அசல் ஆவணம் அதிகாரப்பூர்வமான ஆதாரமாக கருதப்பட வேண்டும். முக்கியமான தகவல்களுக்கு, தொழில்முறை மனித மொழிபெயர்ப்பு பரிந்துரைக்கப்படுகிறது. இந்த மொழிபெயர்ப்பின் பயன்பாட்டால் ஏற்பட்ட எந்தப்பதிலாதல்களுக்கும் அல்லது தவறுப் புரிதல்களுக்கும் நாங்கள் பொறுப்புப் பெறமாட்டோம்.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

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

@ -2,29 +2,29 @@
## Огляд проекту
Це репозиторій з навчальною програмою для вивчення основ веб-розробки для початківців. Програма — це всеосяжний 12-тижневий курс, розроблений Microsoft Cloud Advocates, який включає 24 практичних уроки з JavaScript, CSS та HTML.
Це навчальний репозиторій з курсу основ веб-розробки для початківців. Навчальна програма — це комплексний 12-тижневий курс, розроблений Microsoft Cloud Advocates, що включає 24 практичних уроки, які охоплюють JavaScript, CSS та HTML.
### Основні компоненти
- **Навчальний контент**: 24 структуровані уроки, організовані у модулі на основі проєктів
- **Практичні проєкти**: Тераріум, Гра на друкування, Розширення браузера, Космічна гра, Банківський додаток, Редактор коду та AI чат-асистент
- **Інтерактивні вікторини**: 48 вікторин по 3 запитання в кожній (оцінювання до і після уроку)
- **Підтримка кількох мов**: Автоматичний переклад на 50+ мов за допомогою GitHub Actions
- **Технології**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (для AI-проєктів)
- **Практичні проєкти**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor та AI Chat Assistant
- **Інтерактивні вікторини**: 48 вікторин по 3 питання в кожній (оціночні завдання перед та після уроку)
- **Підтримка багатьох мов**: Автоматичний переклад більше ніж 50 мов за допомогою GitHub Actions
- **Технології**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (для AI проектів)
### Архітектура
- Навчальний репозиторій зі структурою на основі уроків
- Кожна папка уроку містить README, приклади коду та рішення
- Окремі проєкти у власних каталогах (quiz-app, різні проекти уроків)
- Система перекладів за допомогою GitHub Actions (co-op-translator)
- Окремі проєкти в окремих папках (quiz-app, різні проєкти уроків)
- Система перекладів через GitHub Actions (co-op-translator)
- Документація подається через Docsify і доступна у форматі PDF
## Команди налаштування
Цей репозиторій призначено головним чином для споживання навчального контенту. Для роботи з конкретними проектами:
Цей репозиторій призначений переважно для споживання навчального контенту. Для роботи з конкретними проєктами:
### Основне налаштування репозиторію
### Налаштування основного репозиторію
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
@ -37,11 +37,11 @@ cd Web-Dev-For-Beginners
cd quiz-app
npm install
npm run dev # Запустити сервер розробки
npm run build # Зібрати для виробництва
npm run build # Зібрати для продакшн
npm run lint # Запустити ESLint
```
### API банківського проєкту (Node.js + Express)
### API проєкту Bank (Node.js + Express)
```bash
cd 7-bank-project/api
@ -51,23 +51,23 @@ npm run lint # Запустити ESLint
npm run format # Форматувати за допомогою Prettier
```
### Проекти розширення браузера
### Проєкти розширень браузера
```bash
cd 5-browser-extension/solution
npm install
# Дотримуйтеся інструкцій із завантаження розширень, специфічних для браузера
# Дотримуйтесь інструкцій із завантаження розширень, специфічних для браузера
```
### Проекти космічної гри
### Проєкти гри Space
```bash
cd 6-space-game/solution
npm install
# Відкрийте index.html у браузері або використовуйте Live Server
# Відкрийте index.html у браузері або використайте Live Server
```
### Чат-проєкт (Python Backend)
### Проєкт чату (Python Backend)
```bash
cd 9-chat-project/solution/backend/python
@ -76,203 +76,203 @@ pip install openai
python api.py
```
## Розробницький процес
## Робочий процес розробки
### Для контрибуторів контенту
### Для авторів контенту
1. **Форкніть репозиторій** у вашому обліковому записі GitHub
2. **Склонуйте свій форк** локально
1. **Зробіть форк репозиторію** у свій GitHub акаунт
2. **Клонувати ваш форк** локально
3. **Створіть нову гілку** для ваших змін
4. Внесіть зміни до контенту уроків або прикладів коду
5. Тестуйте зміни коду у відповідних каталогах проєктів
6. Надсилайте pull request відповідно до інструкцій з внеску
4. Вносіть зміни у контент уроків або приклади коду
5. Тестуйте внесені зміни у відповідних проєктах
6. Надсилайте pull request відповідно до настанов з внесення змін
### Для учнів
1. Форкіть або склонуйте репозиторій
2. Перейдіть послідовно до каталогів уроків
1. Форк або клон репозиторію
2. Перейдіть до папок уроків послідовно
3. Читайте README файли для кожного уроку
4. Виконуйте вікторини перед уроком на https://ff-quizzes.netlify.app/web/
5. Працюйте з прикладами коду у папках уроків
6. Виконуйте завдання і виклики
7. Пройдіть вікторини після уроку
4. Виконайте вікторини перед уроком на https://ff-quizzes.netlify.app/web/
5. Працюйте з прикладами коду в папках уроків
6. Виконуйте завдання та виклики
7. Здавайте вікторини після уроку
### Живий розвиток
### Жива розробка
- **Документація**: Запустіть `docsify serve` у корені (порт 3000)
- **Quiz App**: Запустіть `npm run dev` у папці quiz-app
- **Проекти**: Використовуйте розширення VS Code Live Server для HTML проектів
- **API-проекти**: Запустіть `npm start` у відповідних каталогах API
- **Документація**: Запускайте `docsify serve` в корені (порт 3000)
- **Quiz App**: Запускайте `npm run dev` в директорії quiz-app
- **Проєкти**: Використовуйте расширення VS Code Live Server для HTML проектів
- **API Проєкти**: Запускайте `npm start` у відповідних API папках
## Інструкції для тестування
## Інструкції з тестування
### Тестування Quiz App
```bash
cd quiz-app
npm run lint # Перевірте на наявність проблем зі стилем коду
npm run build # Переконайтеся, що збірка успішна
npm run build # Переконайтеся, що збірка пройшла успішно
```
### Тестування Bank API
```bash
cd 7-bank-project/api
npm run lint # Перевірте на проблеми зі стилем коду
node server.js # Переконайтеся, що сервер запускається без помилок
npm run lint # Перевірити наявність проблем зі стилем коду
node server.js # Переконатися, що сервер запускається без помилок
```
### Загальний підхід до тестування
- Це навчальний репозиторій без комплексних автоматизованих тестів
- Це навчальний репозиторій без комплексних автоматичних тестів
- Ручне тестування зосереджене на:
- Коректному виконанні прикладів коду без помилок
- Роботі посилань у документації
- Успішній збірці проєктів
- Відповідності прикладів найкращим практикам
- Приклади коду запускаються без помилок
- Посилання в документації працюють коректно
- Проєкти збираються успішно
- Приклади відповідають найкращим практикам
### Перевірки перед відправкою
### Перевірки перед поданням
- Запустіть `npm run lint` в каталогах з package.json
- Перевірте валідність markdown-посилань
- Тестуйте приклади коду у браузері або Node.js
- Переконайтесь, що переклади зберігають правильну структуру
- Запустіть `npm run lint` у директоріях з package.json
- Переконайтесь, що markdown-посилання дійсні
- Тестуйте приклади коду в браузері або Node.js
- Перевірте, що переклади зберігають правильну структуру
## Керівництво зі стилю коду
### JavaScript
- Використовуйте сучасний синтаксис ES6+
- Дотримуйтесь стандартних ESLint конфігурацій у проєктах
- Дотримуйтесь стандартних конфігурацій ESLint у проєктах
- Використовуйте зрозумілі імена змінних та функцій для навчальної ясності
- Додавайте коментарі для пояснення концепцій учням
- Форматуйте код за допомогою Prettier, де налаштовано
- Додавайте коментарі для пояснення концепцій для учнів
- Форматуйте код за допомогою Prettier там, де налаштовано
### HTML/CSS
- Семантичні елементи HTML5
- Принципи адаптивного дизайну
- Чіткі конвенції найменування CSS-класів
- Чіткі конвенції іменування класів
- Коментарі, що пояснюють CSS-техніки для учнів
### Python
- Дотримання керівництва зі стилю PEP 8
- Зрозумілі навчальні приклади коду
- Підказки типів, де це корисно для навчання
- Керівництво по стилю PEP 8
- Чіткі, навчальні приклади коду
- Підказки типів там, де допомагає навчання
### Документація Markdown
### Документація в Markdown
- Чітка ієрархія заголовків
- Блоки коду з вказівкою мови
- Блоки коду з вказанням мови
- Посилання на додаткові ресурси
- Скриншоти та зображення в папках `images/`
- Альтернативний текст для зображень для доступності
- Скриншоти та зображення у папках `images/`
- Атрибут alt для зображень для доступності
### Організація файлів
- Уроки нумеруются послідовно (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}/`
## Збірка та деплоймент
## Збірка і деплоймент
### Деплоймент Quiz App (Azure Static Web Apps)
### Деплой Quiz App (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 при пуші до main
# Розгортає за допомогою робочого процесу GitHub Actions при пуші в main
```
Конфігурація Azure Static Web Apps:
Налаштування Azure Static Web Apps:
- **Розташування додатку**: `/quiz-app`
- **Розташування виводу**: `dist`
- **Папка виводу**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Генерація PDF документації
```bash
npm install # Встановіть docsify-to-pdf
npm run convert # Згенерувати PDF з docs
npm install # Встановити docsify-to-pdf
npm run convert # Згенерувати PDF з документів
```
### Документація на Docsify
### Документація Docsify
```bash
npm install -g docsify-cli # Встановити Docsify глобально
docsify serve # Запустити на localhost:3000
npm install -g docsify-cli # Встановіть Docsify глобально
docsify serve # Запустіть на localhost:3000
```
### Збірка специфічна для проєктів
### Особливі збірки проєктів
Кожен каталог проєкту може мати власний процес збірки:
- Vue-проєкти: `npm run build` створює продакшн-бандли
- Статичні проєкти: без кроку збірки, файли подаються напряму
Кожна директорія проєкту може мати власний процес збірки:
- Vue проєкти: `npm run build` створює продуктивні збірки
- Статичні проєкти: Немає кроку збірки, файли подаються напряму
## Інструкції для Pull Request
## Настанови для Pull Request
### Формат назви
### Формат заголовку
Використовуйте чіткі, описові назви, що вказують на сферу змін:
Використовуйте чіткі, описові заголовки із зазначенням області змін:
- `[Quiz-app] Додати нову вікторину для уроку X`
- `[Lesson-3] Виправити друкарську помилку в проєкті terrarium`
- `[Translation] Додати іспанський переклад уроку 5`
- `[Docs] Оновити інструкції з налаштування`
- `[Lesson-3] Виправлення помилки в проєкті terrarium`
- `[Translation] Додати іспанський переклад для уроку 5`
- `[Docs] Оновити інструкції налаштування`
### Необхідні перевірки
### Обов’язкові перевірки
Перед надсиланням PR:
1. **Якість коду**:
- Запустіть `npm run lint` у відповідних проектах
- Виправте всі помилки і застереження лінтера
- Запустіть `npm run lint` у відповідних директоріях
- Виправте всі помилки та попередження лінтера
2. **Перевірка збірки**:
- Запустіть `npm run build` за потребою
- Переконайтесь у відсутності помилок збірки
- Запустіть `npm run build`, якщо застосовно
- Переконайтесь, що немає помилок збірки
3. **Перевірка посилань**:
- Тестуйте всі markdown-посилання
3. **Валідація посилань**:
- Перевірте всі markdown-посилання
- Переконайтесь, що посилання на зображення працюють
4. **Перевірка контенту**:
- Коректність орфографії і граматики
- Правильність та навчальна цінність прикладів коду
- Переклади збережені точно і відповідно
4. **Огляд контенту**:
- Перевірка орфографії та граматики
- Переконайтесь, що приклади коду правильні та навчальні
- Перевірте переклади на збереження оригінального змісту
### Вимоги до внеску
- Підпишіться під Microsoft CLA (автоматична перевірка при першому PR)
- Дотримуйтесь [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Погодитись з CLA Microsoft (автоматична перевірка при першому PR)
- Дотримуватись [Microsoft Open Source Коду поведінки](https://opensource.microsoft.com/codeofconduct/)
- Див. [CONTRIBUTING.md](./CONTRIBUTING.md) для детальних вказівок
- Посилайтесь на номери issue у описі PR, якщо потрібно
- Зазначати номери issue в описі PR, якщо потрібно
### Процес рев’ю
### Процес рецензування
- PR переглядають мейнтейнерами і спільнотою
- Пріоритет — зрозумілість для навчання
- Приклади коду мають відповідати найкращим практикам
- Переклади перевіряються на точність і культурну доречність
- PR рецензують підтримувачі та спільнота
- Пріоритет надається зрозумілості для навчання
- Приклади коду повинні відповідати сучасним найкращим практикам
- Переклади рецензуються на точність та культурну відповідність
## Система перекладів
### Автоматичний переклад
- Використовує GitHub Actions з workflow co-op-translator
- Автоматично перекладає на 50+ мов
- Джерельні файли у головних каталогах
- Переклади у папках `translations/{language-code}/`
- Використовує GitHub Actions з робочим процесом co-op-translator
- Автоматичний переклад на 50+ мов
- Джерельні файли у основних директоріях
- Перекладені файли у папках `translations/{language-code}/`
### Додавання покращень вручну
### Додавання ручних покращень перекладу
1. Знайдіть файл у `translations/{language-code}/`
2. Вносьте покращення, зберігаючи структуру
3. Переконайтесь, що приклади коду працюють
4. Тестуйте локалізований контент вікторин
2. Внесіть покращення, зберігаючи структуру
3. Переконайтесь, що приклади коду залишаються працездатними
4. Протестуйте локалізований контент вікторин
### Метадані перекладу
@ -295,114 +295,114 @@ CO_OP_TRANSLATOR_METADATA:
**Quiz app не запускається**:
- Перевірте версію Node.js (рекомендується v14+)
- Видаліть `node_modules` та `package-lock.json`, потім запустіть `npm install` знову
- Видаліть `node_modules` та `package-lock.json`, повторно виконайте `npm install`
- Перевірте конфлікти портів (за замовчуванням Vite використовує порт 5173)
**API сервер не запускається**:
- Перевірте, що версія Node.js відповідає мінімуму (node >=10)
- Переконайтесь, що порт не зайнятий
- Всі залежності встановлено за допомогою `npm install`
**Сервер API не запускається**:
- Переконайтесь, що версія Node.js >=10
- Перевірте, чи порт не зайнятий
- Переконайтеся, що всі залежності встановлені командою `npm install`
**Розширення браузера не завантажується**:
- Перевірте правильність форматування manifest.json
- Подивіться консоль браузера на наявність помилок
- Дотримуйтесь інструкцій по встановленню для конкретного браузера
- Перевірте консоль браузера на наявність помилок
- Дотримуйтеся інструкцій з встановлення розширень для конкретного браузера
**Проблеми з Python чат-проєктом**:
- Переконайтесь, що встановлено пакет OpenAI: `pip install openai`
- Задано змінну середовища GITHUB_TOKEN
**Проблеми з Python чатом**:
- Переконайтесь, що пакет OpenAI встановлено: `pip install openai`
- Перевірте, що змінна середовища GITHUB_TOKEN встановлена
- Перевірте права доступу до GitHub Models
**Docsify не подає документацію**:
- Встановіть docsify-cli глобально: `npm install -g docsify-cli`
- Запускайте з кореневого каталогу репозиторію
- Переконайтеся, що існує `docs/_sidebar.md`
- Переконайтесь, що файл `docs/_sidebar.md` існує
### Поради щодо середовища розробки
### Поради для середовища розробки
- Використовуйте VS Code з розширенням Live Server для HTML проектів
- Встановіть ESLint і Prettier для узгодженого форматування
- Встановіть розширення ESLint і Prettier для узгодженого форматування
- Використовуйте DevTools браузера для налагодження JavaScript
- Для Vue-проєктів встановіть Vue DevTools розширення для браузера
- Для Vue проєктів встановіть розширення Vue DevTools для браузера
### Питання продуктивності
### Міркування щодо продуктивності
- Велика кількість перекладених файлів (50+ мов) робить повні клонування великими
- Велика кількість перекладених файлів (50+ мов) призводить до великих розмірів повних клонів
- Використовуйте shallow clone, якщо працюєте лише з контентом: `git clone --depth 1`
- Виключайте переклади з пошуку, коли працюєте з англійським контентом
- Виключайте переклади з пошуку при роботі з англійським контентом
- Процеси збірки можуть бути повільними при першому запуску (npm install, збірка Vite)
## Розгляд питань безпеки
## Міркування безпеки
### Змінні середовища
- Ключі API НЕ слід комітити у репозиторій
- Використовуйте `.env` файли (вже в `.gitignore`)
- Документуйте необхідні змінні середовища в README проєктів
- API ключі не повинні комітитись у репозиторій
- Використовуйте `.env` файли (вже додані у `.gitignore`)
- Документуйте необхідні змінні середовища у README проєктів
### Python проєкти
- Використовуйте віртуальні середовища: `python -m venv venv`
- Тримайте залежності оновленими
- Токени GitHub повинні мати мінімально потрібні права
- Тримайте залежності в актуальному стані
- Токени GitHub повинні мати мінімально необхідні права доступу
### Доступ до GitHub Models
- Для GitHub Models потрібні Персональні Токени Доступу (PAT)
- Зберігайте токени як змінні середовища
- Ніколи не комітьте токени або облікові дані
- Особисті токени доступу (PAT) потрібні для GitHub Models
- Токени слід зберігати як змінні середовища
- Ніколи не комітьте токени чи облікові дані
## Додаткові нотатки
### Цільова аудиторія
- Абсолютні початківці у веб-розробці
- Студенти та самонавчальні особи
- Викладачі, які використовують програму у класах
- Контент розроблений з урахуванням доступності та поступового навчання
- Повні початківці у веб-розробці
- Студенти та самонавчальні
- Викладачі, які використовують курс у класах
- Контент розроблений для доступності та поступового розвитку навичок
### Освітня філософія
- Підхід навчання на основі проєктів
- Навчання на основі проєктів
- Часті перевірки знань (вікторини)
- Практичні вправи з кодування
- Приклади застосування у реальному світі
- Орієнтованість на основи перед фреймворками
- Акцент на основах перед фреймворками
### Підтримка репозиторію
- Активна спільнота учнів та контрибуторів
- Регулярне оновлення залежностей і контенту
- Моніторинг issues та обговорень підтримуючими
- Оновлення перекладів автоматизовано через GitHub Actions
- Активна спільнота учнів та дописувачів
- Регулярні оновлення залежностей та контенту
- Моніторинг issue та обговорень підтримувачами
- Переклади оновлюються автоматично через GitHub Actions
### Пов’язані ресурси
### Споріднені ресурси
- [Microsoft Learn модулі](https://docs.microsoft.com/learn/)
- [Ресурси Student Hub](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) рекомендований для учнів
- Додаткові курси: Генеративний AI, Data Science, ML, IoT навчальні програми
- Додаткові курси: генеративний AI, Data Science, ML, IoT курси доступні
### Робота з конкретними проєктами
Для детальних інструкцій по проектах дивіться README файли у:
- `quiz-app/README.md` - застосунок вікторин на Vue 3
- `7-bank-project/README.md` - банківський застосунок з аутентифікацією
- `5-browser-extension/README.md` - розробка розширень браузера
- `6-space-game/README.md` - розробка гри на Canvas
- `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` - Розробка гри на Canvas
- `9-chat-project/README.md` - Проєкт AI чат-помічника
### Структура монорепозиторію
Хоч це і не традиційний монорепозиторій, цей репозиторій містить кілька незалежних проєктів:
- Кожен урок є самостійним
- Проекти не ділять залежностей
- Працюйте з окремими проектами без впливу на інші
- Клонуйте весь репозиторій для повного досвіду програми
Хоча це не традиційний монорепозиторій, він містить кілька незалежних проєктів:
- Кожен урок є автономним
- Проєкти не ділять залежності
- Працюйте над окремими проєктами без впливу на інші
- Клонуйте весь репозиторій для повного навчального досвіду
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Відмова від відповідальності**:
Цей документ було перекладено за допомогою сервісу автоматичного перекладу [Co-op Translator](https://github.com/Azure/co-op-translator). Хоча ми прагнемо до точності, будь ласка, майте на увазі, що автоматичні переклади можуть містити помилки або неточності. Оригінальний документ рідною мовою слід вважати авторитетним джерелом. Для критичної інформації рекомендується звертатися до професійного людського перекладу. Ми не несемо відповідальності за будь-які непорозуміння чи неправильне тлумачення, що виникли внаслідок використання цього перекладу.
**Застереження**:
Цей документ було перекладено за допомогою сервісу автоматичного перекладу [Co-op Translator](https://github.com/Azure/co-op-translator). Незважаючи на наші зусилля забезпечити точність, просимо враховувати, що автоматичні переклади можуть містити помилки чи неточності. Оригінальний документ рідною мовою слід вважати авторитетним джерелом. Для критично важливої інформації рекомендується професійний людський переклад. Ми не несемо відповідальності за будь-які непорозуміння чи неправильні тлумачення, що виникли внаслідок використання цього перекладу.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->
Loading…
Cancel
Save