diff --git a/translations/lt/.co-op-translator.json b/translations/lt/.co-op-translator.json index d15f5f607..cbcd26322 100644 --- a/translations/lt/.co-op-translator.json +++ b/translations/lt/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T10:27:00+00:00", + "translation_date": "2026-02-06T12:07:48+00:00", "source_file": "AGENTS.md", "language_code": "lt" }, diff --git a/translations/lt/AGENTS.md b/translations/lt/AGENTS.md index 975270072..1b79a15ce 100644 --- a/translations/lt/AGENTS.md +++ b/translations/lt/AGENTS.md @@ -2,43 +2,43 @@ ## Projekto apžvalga -Tai yra edukacinis mokymo planas, skirtas pradedantiesiems mokyti interneto kūrimo pagrindų. Mokymo programa yra išsami 12 savaičių kursų programa, sukurta Microsoft Cloud Advocates, apimanti 24 praktines pamokas apie JavaScript, CSS ir HTML. +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. -### Pagrindiniai komponentai +### Pagrindinės sudedamosios dalys -- **Edukacinis turinys**: 24 struktūruotos pamokos, organizuotos į projektinius modulius -- **Praktiniai projektai**: Terariumas, Rašymo žaidimas, Naršyklės plėtinys, Kosmoso žaidimas, Banko programa, Kodo redaktorius ir DI pokalbių asistentas -- **Interaktyvūs testai**: 48 testai su po 3 klausimus kiekviename (prieš/post pamoką įvertinimai) -- **Daugiakalbystė**: Automatiniai vertimai į 50+ kalbų per GitHub Actions +- **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 - **Technologijos**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (DI projektams) ### Architektūra -- Edukacinis saugykla su pamokų struktūra -- Kiekvienas pamokos katalogas turi README, kodo pavyzdžius ir sprendimus -- Atskiri projektai atskiruose kataloguose (quiz-app, įvairūs pamokų projektai) -- Vertimų sistema naudojant GitHub Actions (co-op-translator) -- Dokumentacija tiekiama per Docsify ir prieinama kaip PDF +- 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 -## Paleidimo komandos +## Nustatymo komandos -Ši saugykla daugiausia skirta edukaciniam turiniui vartoti. Dirbant su konkrečiais projektais: +Ši saugykla skirta pirmiausia mokymuisi. Dirbant su konkrečiais projektais: -### Pagrindinės saugyklos paleidimas +### Pagrindinės saugyklos nustatymas ```bash git clone https://github.com/microsoft/Web-Dev-For-Beginners.git cd Web-Dev-For-Beginners ``` -### Quiz App paleidimas (Vue 3 + Vite) +### Quiz App nustatymas (Vue 3 + Vite) ```bash cd quiz-app npm install -npm run dev # Paleiskite kūrimo serverį -npm run build # Sukurkite gamybai -npm run lint # Vykdykite ESLint +npm run dev # Paleisti kūrimo serverį +npm run build # Sukurti gamybai +npm run lint # Vykdyti ESLint ``` ### Banko projekto API (Node.js + Express) @@ -47,7 +47,7 @@ npm run lint # Vykdykite ESLint cd 7-bank-project/api npm install npm start # Paleisti API serverį -npm run lint # Paleisti ESLint +npm run lint # Vykdyti ESLint npm run format # Formatuoti su Prettier ``` @@ -56,10 +56,10 @@ npm run format # Formatuoti su Prettier ```bash cd 5-browser-extension/solution npm install -# Sekite naršyklės specifines plėtinių įkėlimo instrukcijas +# Vadovaukitės naršyklės konkrečiais plėtinių įkėlimo nurodymais ``` -### Kosmoso žaidimo projektai +### Kosminio žaidimo projektai ```bash cd 6-space-game/solution @@ -67,42 +67,42 @@ npm install # Atidarykite index.html naršyklėje arba naudokite Live Server ``` -### Pokalbių projekto (Python backend) paleidimas +### Pokalbių projekto (Python backend) nustatymas ```bash cd 9-chat-project/solution/backend/python pip install openai -# Nustatykite GITHUB_TOKEN aplinkos kintamąjį +# Nustatyti GITHUB_TOKEN aplinkos kintamąjį python api.py ``` -## Kūrimo darbo eiga +## Vystymo darbo eiga -### Turinį prisidedantiesiems +### Turinį prisidedantiems -1. **Padarykite saugyklos fork'ą** savo GitHub paskyroje -2. **Klonuokite savo fork'ą** lokaliai +1. **Fork'inkite saugyklą** į savo GitHub paskyrą +2. **Klonuokite savo fork'ą** vietoje 3. **Sukurkite naują šaką** savo pakeitimams -4. Keiskite pamokų turinį ar kodo pavyzdžius -5. Išbandykite kodo pakeitimus atitinkamuose projektų kataloguose -6. Pateikite pull request pagal indėlio taisykles +4. Keiskite pamokų turinį arba kodo pavyzdžius +5. Testuokite kodo pakeitimus atitinkamuose projekto kataloguose +6. Pateikite pull request pagal kontributavimo taisykles -### Moksleiviams +### Mokiniams -1. Padarykite fork arba klonuokite saugyklą -2. Sekite pamokų katalogus paeiliui +1. Fork'inkite arba klonuokite saugyklą +2. Sekite per pamokų katalogus iš eilės 3. Skaitykite kiekvienos pamokos README failus -4. Atlikite priešpamokinius testus adresu https://ff-quizzes.netlify.app/web/ +4. Užbaikite priešpamokos testus adresu https://ff-quizzes.netlify.app/web/ 5. Dirbkite su kodo pavyzdžiais pamokų kataloguose 6. Atlikite užduotis ir iššūkius -7. Atlikite po pamokos testus +7. Laikykite popamokos testus -### Tiesioginė plėtra +### Gyvas vystymas -- **Dokumentacija**: vykdykite `docsify serve` šaknyje (portas 3000) -- **Quiz App**: vykdykite `npm run dev` quiz-app kataloge -- **Projektai**: naudokite VS Code Live Server plėtinį HTML projektams -- **API projektai**: vykdykite `npm start` atitinkamuose API kataloguose +- **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 ## Testavimo instrukcijos @@ -111,85 +111,85 @@ python api.py ```bash cd quiz-app npm run lint # Patikrinkite kodo stiliaus problemas -npm run build # Patikrinkite, ar sėkmingai sukompiliuota +npm run build # Patvirtinkite, kad statyba sėkminga ``` ### Banko API testavimas ```bash cd 7-bank-project/api -npm run lint # Patikrinti kodo stiliaus problemas -node server.js # Patvirtinti, kad serveris paleidžiamas be klaidų +npm run lint # Patikrinkite kodo stiliaus problemas +node server.js # Patikrinkite, ar serveris paleidžiamas be klaidų ``` -### Bendra testavimo tvarka +### Bendras testavimo metodas -- Tai edukacinė saugykla be išsamios automatizuotos testavimo sistemos -- Rankinis testavimas orientuotas į: +- Tai yra mokomoji saugykla be išsamių automatinių testų +- Rankinis testavimas apima: - Kodo pavyzdžiai veikia be klaidų - Dokumentacijos nuorodos veikia tinkamai - - Projektų surinkimai sėkmingi - - Pavyzdžiai atitinka geriausias praktikas + - Projektų kompiliacijos baigiamos sėkmingai + - Pavyzdžiai atitinka gerąsias praktikas -### Prieš pateikiant patikrinimus +### Patikrinimai prieš pateikiant -- Vykdykite `npm run lint` kataloguose su package.json -- Patikrinkite, ar markdown nuorodos galioja -- Testuokite kodo pavyzdžius naršyklėje ar Node.js aplinkoje +- 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 - Įsitikinkite, kad vertimai išlaiko tinkamą struktūrą -## Kodo stiliaus gaires +## Kodo stiliaus gairės ### JavaScript - Naudokite modernią ES6+ sintaksę -- Laikykitės ESLint konfigūracijų projektuose -- Naudokite prasmingus kintamųjų ir funkcijų vardus edukaciniam aiškumui -- Rašykite komentarus paaiškinančius koncepcijas mokiniams -- Formatuokite su Prettier, jei jis konfigūruotas +- Laikykitės standartinių ESLint konfigūracijų 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 ### HTML/CSS -- Semantiški HTML5 elementai -- Responsyvus dizainas -- Aiškios klasės pavadinimų konvencijos -- Komentarai paaiškinantys CSS technikas mokiniams +- Semantiniai HTML5 elementai +- Reaguojančio dizaino principai +- Aiškios klasių pavadinimų konvencijos +- Komentarai, paaiškinantys CSS technikas mokiniams ### Python -- PEP 8 stiliaus gairės -- Aiškūs, edukaciniai kodo pavyzdžiai -- Tipų užuominos, kur mokymuisi naudingos +- Laikytis PEP 8 stiliaus gairių +- Aiškūs mokomieji kodo pavyzdžiai +- Naudokite tipų užuominas ten, kur tai padeda mokantis ### Markdown dokumentacija - Aiški antraščių hierarchija -- Kodo blokai su kalbos nurodymu +- Kodo blokai nurodant kalbą - Nuorodos į papildomus šaltinius -- Ekrano kopijos ir vaizdai `images/` kataloguose -- Alt tekstas paveikslėliams dėl prieinamumo +- Ekrano nuotraukos ir vaizdai `images/` kataloguose +- Alternatyvus tekstas vaizdams dėl prieinamumo ### Failų organizavimas -- Pamokos sunumeruotos paeiliui (1-getting-started-lessons, 2-js-basics ir t.t.) -- Kiekvienas projektas turi `solution/` ir dažnai `start/` arba `your-work/` katalogus -- Vaizdai saugomi pamokai pritaikytuose `images/` aplankuose -- Vertimai pagal kalbas kataloguose `translations/{language-code}/` +- 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 -## Surinkimas ir diegimas +## Konstravimas ir diegimas ### Quiz App diegimas (Azure Static Web Apps) -Quiz-app sukonfigūruotas Azure Static Web Apps diegimui: +quiz-app yra sukonfigūruotas Azure Static Web Apps diegimui: ```bash cd quiz-app npm run build # Sukuria dist/ aplanką -# Diegia per GitHub Actions darbų eigą, kai į pagrindinį šaką nusiunčiama naujinimų +# Diegia per GitHub Actions darbo eigą į main pusę stumiant ``` Azure Static Web Apps konfigūracija: -- **Programos vieta**: `/quiz-app` +- **Taikomosios programos vieta**: `/quiz-app` - **Išvesties vieta**: `dist` - **Darbo eiga**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` @@ -197,86 +197,86 @@ Azure Static Web Apps konfigūracija: ```bash npm install # Įdiekite docsify-to-pdf -npm run convert # Sugeneruoti PDF iš dokumentų +npm run convert # Generuoti PDF iš dokumentų ``` ### Docsify dokumentacija ```bash npm install -g docsify-cli # Įdiekite Docsify globaliai -docsify serve # Paleiskite localhost:3000 adresu +docsify serve # Pateikite tarnybą adresu localhost:3000 ``` -### Projektų specifiniai surinkimai +### Projektams skirtas konstravimas -Kiekvienas projekto katalogas gali turėti savo surinkimo procesą: -- Vue projektai: `npm run build` kuria gamybinius paketus -- Statiniai projektai: jokių surinkimo žingsnių, failai tiekiami tiesiogiai +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 -## Pull request gairės +## Pull Request gairės -### Pavadinimo formatas +### Antraštės formatas -Naudokite aiškius, aprašomuosius pavadinimus, nurodančius pokyčių sritį: -- `[Quiz-app] Pridėtas naujas testas pamokai X` -- `[Lesson-3] Ištaisyta rašybos klaida terariumo projekte` -- `[Translation] Pridėtas ispanų vertimas pamokai 5` -- `[Docs] Atnaujintos diegimo instrukcijos` +Naudokite aiškias, apibūdinančias antraštes, nurodančias pokyčių 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` -### Būtini patikrinimai +### Būtinos patikros Prieš pateikiant PR: 1. **Kodo kokybė**: - - Vykdykite `npm run lint` paveiktuose projekto kataloguose - - Ištaisyti visi lint klaidos ir įspėjimai + - Paleiskite `npm run lint` atitinkamuose projekto kataloguose + - Ištaisykite visas lint klaidas ir įspėjimus -2. **Surinkimo patvirtinimas**: - - Jeigu taikoma, paleiskite `npm run build` - - Įsitikinkite, kad nėra surinkimo klaidų +2. **Konstravimo tikrinimas**: + - Jei taikoma, paleiskite `npm run build` + - Užtikrinkite, kad konstravimo metu nėra klaidų 3. **Nuorodų patikra**: - Patikrinkite visas markdown nuorodas - - Patvirtinkite, kad paveikslėlių nuorodos veikia + - Patvirtinkite, kad vaizdų nuorodos veikia 4. **Turinio peržiūra**: - - Patikrinkite rašybą ir gramatiką - - Įsitikinkite, kad kodo pavyzdžiai yra teisingi ir edukaciniai - - Patvirtinkite, kad vertimai išlaiko originalią prasmę + - Tikrinkite rašybą ir gramatiką + - Įsitikinkite, kad kodo pavyzdžiai yra teisingi ir mokomieji + - Patikrinkite, kad vertimai išlaiko pradinę reikšmę ### Indėlio reikalavimai -- Sutinkate su Microsoft CLA (automatinis patikrinimas pirmame PR) -- Laikykitės [Microsoft atvirojo kodo elgesio kodekso](https://opensource.microsoft.com/codeofconduct/) -- Žr. [CONTRIBUTING.md](./CONTRIBUTING.md) išsamioms gairėms -- Nurodykite susijusių issue numerius PR aprašyme, jei taikoma +- 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 ### Peržiūros procesas -- PR peržiūri prižiūrėtojai ir bendruomenė -- Prioritetas teikiamas edukacinės aiškumo užtikrinimui -- Kodo pavyzdžiai turėtų atitikti dabartines geriausias praktikas -- Vertimai tikrinami dėl tikslumo ir kultūrinio tinkamumo +- PR peržiūri palaikytojai ir bendruomenė +- Prioritetas mokymosi aiškumui +- Kodo pavyzdžiai turi atitikti dabartines gerąsias praktikas +- Vertimai peržiūrimi dėl tikslumo ir kultūrinio atitikimo ## Vertimų sistema ### Automatinis vertimas -- Naudoja GitHub Actions su co-op-translator darbo eiga -- Automatiškai verčia į 50+ kalbų -- Šaltiniai pagrindiniuose kataloguose -- Išversti failai kataloguose `translations/{language-code}/` +- Naudojamos 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 -### Rankinių vertimų patobulinimai +### Rankinių vertimo patobulinimų pridėjimas -1. Raskite failą kataloge `translations/{language-code}/` +1. Suraskite failą `translations/{language-code}/` 2. Atlikite patobulinimus išlaikydami struktūrą -3. Užtikrinkite, kad kodo pavyzdžiai išlieka funkcionuojantys -4. Testuokite bet kokį lokalizuotą testų turinį +3. Įsitikinkite, kad kodo pavyzdžiai lieka veikiantys +4. Testuokite lokalizuotą testų turinį -### Vertimų metaduomenys +### Vertimų meta duomenys -Išverstų failų antraštė metadata: +Išversti failai turi meta duomenų antraštę: ```markdown ``` -## Derinimas ir trikčių šalinimas +## Derinimas ir problemų sprendimas ### Dažnos problemos **Quiz app nepaleidžiamas**: - Patikrinkite Node.js versiją (rekomenduojama v14+) -- Ištrinkite `node_modules` ir `package-lock.json`, vėl vykdykite `npm install` -- Patikrinkite ar nėra uosto konflikto (numatytas: Vite naudoja portą 5173) +- Ištrinkite `node_modules` ir `package-lock.json`, paleiskite `npm install` iš naujo +- Patikrinkite prievadų konfliktus (numatytasis: Vite naudoja 5173 portą) **API serveris nepaleidžiamas**: -- Patikrinkite, ar Node.js versija atitinka reikalavimus (node >=10) -- Patikrinkite ar uostas neužimtas -- Užtikrinkite, kad visos priklausomybės įdiegtos su `npm install` +- Įsitikinkite, kad Node.js versija yra pakankama (node >=10) +- Patikrinkite ar prievadas neužimtas +- Įsitikinkite, kad visos priklausomybės įdiegtos su `npm install` -**Naršyklės plėtinys nepasirodo**: -- Patikrinkite, ar manifest.json tinkamai suformatuotas -- Peržiūrėkite naršyklės konsolėje klaidas -- Laikykitės naršyklės plėtinio diegimo instrukcijų +**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 **Python pokalbių projekto problemos**: -- Užtikrinkite, kad įdiegta OpenAI biblioteka: `pip install openai` -- Patikrinkite, ar GITHUB_TOKEN aplinkos kintamasis nustatytas -- Patikrinkite prieigą prie GitHub modelių leidimų +- Įdiekite OpenAI paketą: `pip install openai` +- Įsitikinkite, kad GITHUB_TOKEN aplinkos kintamasis yra nustatytas +- Patikrinkite prieigos leidimus GitHub modeliams -**Docsify nedeliveruoja dokumentacijos**: +**Docsify nepateikia dokumentacijos**: - Įdiekite docsify-cli globaliai: `npm install -g docsify-cli` -- Paleiskite iš saugyklos šaknies katalogo -- Patikrinkite, kad egzistuoja `docs/_sidebar.md` +- Paleiskite iš saugyklos šakninio katalogo +- Įsitikinkite, kad `docs/_sidebar.md` egzistuoja -### Kūrimo aplinkos patarimai +### Vystymo aplinkos patarimai - Naudokite VS Code su Live Server plėtiniu HTML projektams -- Įdiekite ESLint ir Prettier plėtinius nuosekliam formatavimui -- Naudokite naršyklės DevTools JavaScript derinimui +- Diekite ESLint ir Prettier plėtinius vienodam formatavimui +- Naudokitės naršyklės DevTools JavaScript derinimui - Vue projektams įdiekite Vue DevTools naršyklės plėtinį -### Veikimo našumo aspektai +### Veikimo efektyvumo aspektai -- Daug išverstų failų (50+ kalbų) reiškia, kad pilni klonai yra dideli -- Naudokite seklų klonavimą, jei dirbate tik su turiniu: `git clone --depth 1` -- Išskirkite vertimus iš paieškų, kai dirbate su anglų turiniu -- Surinkimo procesai gali būti lėti pirmais paleidimais (npm install, Vite build) +- 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) ## Saugumo aspektai ### Aplinkos kintamieji -- API raktai neturi būti įtraukiami į saugyklą -- Naudokite `.env` failus (jie jau įtraukti į `.gitignore`) -- Dokumentuokite reikiamus aplinkos kintamuosius projekto README failuose +- API raktai niekada neturėtų būti įsipareigoti į repositoriją +- Naudokite `.env` failus (jau įtrauktus į `.gitignore`) +- Dokumentuokite reikiamus aplinkos kintamuosius projektų README ### Python projektai - Naudokite virtualias aplinkas: `python -m venv venv` - Laikykite priklausomybes atnaujintas -- GitHub tokenai turėtų turėti minimalius būtinus leidimus +- GitHub žetonai turi turėti minimalų reikiamą leidimą ### GitHub modelių prieiga -- Asmeniniai prieigos tokenai (PAT) reikalingi GitHub modeliams -- Tokenai turi būti saugomi kaip aplinkos kintamieji -- Niekada neįtraukti tokenų ar prisijungimo duomenų į saugyklą +- Reikia asmeninių prieigos žetonų (PAT) GitHub modeliams +- Žetonus laikykite kaip aplinkos kintamuosius +- Niekada neįsipareigokite žetonų ar prisijungimų ## Papildomos pastabos ### Tikslinė auditorija - Visiškai pradedantieji interneto kūrime -- Studentai ir savarankiški mokiniai +- Studentai ir savimokos siekiantys asmenys - Mokytojai, naudojantys mokymo programą klasėse -- Turinys skirtas prieinamumui ir įgūdžių palaipsniui vystymui +- Turinys sukurtas prieinamumui ir žingsniniam įgūdžių lavinimui -### Edukacinė filosofija +### Mokomoji filosofija - Mokymasis per projektus - Dažni žinių patikrinimai (testai) -- Praktiniai kodo uždaviniai +- Praktiniai kodavimo pratimai - Realaus pasaulio taikymo pavyzdžiai -- Dėmesys pagrindams prieš keruklius +- Akcentas ant pagrindų prieš perėjimą prie karkasų ### Saugyklos priežiūra -- Aktyvi mokinių ir prisidedančiųjų bendruomenė +- Aktyvi mokinių ir prisidėjusių bendruomenė - Reguliarūs priklausomybių ir turinio atnaujinimai -- Problemų ir diskusijų stebėjimą atlieka prižiūrėtojai -- Vertimų atnaujinimai automatiškai per GitHub Actions +- Problemos ir diskusijos stebimos palaikytojų +- Vertimų atnaujinimai automatiniai per GitHub Actions -### Susiję ištekliai +### Susiję šaltiniai - [Microsoft Learn moduliai](https://docs.microsoft.com/learn/) -- [Studentų centras](https://docs.microsoft.com/learn/student-hub/) +- [Student Hub resursai](https://docs.microsoft.com/learn/student-hub/) - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) rekomenduojamas mokiniams -- Papildomi kursai: Generatyvus AI, Duomenų mokslas, ML, IoT programos prieinamos +- Papildomi kursai: Generative AI, Duomenų mokslas, ML, IoT mokymo programos prieinamos ### Darbas su konkrečiais projektais -Išsamias instrukcijas apie atskirus projektus rasite README failuose: -- `quiz-app/README.md` - Vue 3 testų aplikacija +Išsamias instrukcijas apie atskirus projektus žr. README failuose: +- `quiz-app/README.md` - Vue 3 testų taikomoji programa - `7-bank-project/README.md` - Banko programa su autentifikacija -- `5-browser-extension/README.md` - Naršyklės plėtinio kūrimas -- `6-space-game/README.md` - Canvas pagrindu žaidimo kūrimas +- `5-browser-extension/README.md` - Naršyklės plėtinių vystymas +- `6-space-game/README.md` - Canvas pagrindu sukurtas žaidimas - `9-chat-project/README.md` - DI pokalbių asistento projektas ### Monorepo struktūra @@ -397,12 +397,12 @@ Išsamias instrukcijas apie atskirus projektus rasite README failuose: Nors tai nėra tradicinis monorepo, ši saugykla talpina kelis nepriklausomus projektus: - Kiekviena pamoka yra savarankiška - Projektai nesidalina priklausomybėmis -- Darbas su atskirais projektais nekeičia kitų -- Klonuokite visą saugyklą, jei norite pilnos mokymo programos patirties +- Dirbkite su atskirais projektais nepaveikdami kitų +- Klonuokite visą repositoriją, kad gautumėte pilną mokymo programą --- -**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 jo gimtąja kalba turėtų būti laikomas autoritetingu šaltiniu. Dėl svarbios informacijos rekomenduojamas profesionalus vertimas žmogaus. Mes neatsakome už bet kokius nesusipratimus ar klaidingus interpretavimus, kylančius dėl šio vertimo naudojimo. +**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. \ No newline at end of file diff --git a/translations/ta/.co-op-translator.json b/translations/ta/.co-op-translator.json index 925ee949f..830bc2e25 100644 --- a/translations/ta/.co-op-translator.json +++ b/translations/ta/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T10:28:27+00:00", + "translation_date": "2026-02-06T12:09:08+00:00", "source_file": "AGENTS.md", "language_code": "ta" }, diff --git a/translations/ta/AGENTS.md b/translations/ta/AGENTS.md index 7759493ee..b0829a8c3 100644 --- a/translations/ta/AGENTS.md +++ b/translations/ta/AGENTS.md @@ -1,65 +1,65 @@ # AGENTS.md -## Project Overview +## திட்டம் கண்ணோட்டம் -இந்த கொள்கை தொடங்கும் பயனாளிகளுக்கு வலை தள மேம்பாட்டின் அடிப்படைகளை கற்பிக்க ஒரு கல்வி பாடத்திட்டக் களஞ்சியமாகும். இந்த பாடத்திட்டம் Microsoft Cloud Advocates உருவாக்கிய ஒரு விரிவான 12 வார பாடநெறி, இதில் 24 செயலில் பங்கெடுக்கும் பாடங்கள் உள்ளன, அவை JavaScript, CSS மற்றும் HTML-ஐ பொறுத்தவை. +இது புதியவர்களுக்கு வலை வளர்ச்சியின் அடிப்படைகளை கற்பிக்க ஒரு கல்விச் பாடத்திட்ட சேமிப்பகமாகும். இந்த பாடத்திட்டம் 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 Setup (Vue 3 + Vite) +### Quiz App அமைப்பு (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 run lint # ESLint-ஐ இயக்கவும் +npm start # API சேவையகத்தைத் தொடங்கு +npm run lint # ESLint ஐ இயக்குக npm run format # Prettier உடன் வடிவமைக்கவும் ``` -### Browser Extension Projects +### Browser Extension திட்டங்கள் ```bash cd 5-browser-extension/solution npm install -# உலாவி-நிபந்தனை விரிவாக்க ஏற்றும் அறிவுறுத்தல்களை பின்பற்றவும் +# உலாவி-சந்தான நீட்டிப்பு ஏற்றும் குறிப்புகளை பின்பற்றவும் ``` -### Space Game Projects +### Space Game திட்டங்கள் ```bash cd 6-space-game/solution @@ -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. பங்களிப்பு வழிகாட்டுதல்களைப் பின்பற்றிக் கூர்வுகளை சமர்ப்பிக்கவும் +1. உங்கள் GitHub கணக்கிற்கு இந்த சேமிப்பகத்தை **fork செய்யவும்** +2. உங்கள் fork ஐ **கோப்புறையில் கிளோன் செய்யவும்** +3. உங்கள் மாற்றங்களுக்கு புதிய கிளைக் உருவாக்கவும் +4. பாட உள்ளடக்கம் அல்லது குறியீடு எடுத்துக்காட்டுகளில் மாற்றங்கள் செய்யவும் +5. பொருத்தமான திட்ட அடைவுகளில் குறியீடு மாற்றங்களை சோதனை செய்யவும் +6. பங்கேற்புத் தளம் வழிகாட்டிக் குறிப்புகளை பின்பற்றி pull requests சமர்ப்பிக்கவும் -### For Learners +### கற்பவர்கள் குடி -1. களஞ்சியத்தை fork செய்ய அல்லது கிளோன் செய்யவும் -2. பாட பதிப்புகள் அடைவுகளில் தொடர் முறையில் செல்லவும் -3. ஒவ்வொரு பாடத்திற்கும் README கோப்புகளைப் படிக்கவும் -4. https://ff-quizzes.netlify.app/web/ இல் முந்தைய பாடத்திற்கான வினாடி வினாக்களை முடிக்கவும் -5. பாட அடைவுகளில் குறியீடு உதாரணங்களால் வேலை செய்யவும் -6. வேலைப்பாடுகளையும் சவால்களையும் முடிக்கவும் -7. பின்னர் பாடத்திற்கான வினாடி வினாக்களை எடுத்துக்கொள்ளவும் +1. சேமிப்பகத்தை fork அல்லது clone செய்யவும் +2. பாட அடைவுகளை தொடர் முறையில் செல்லவும் +3. ஒவ்வொரு பாடத்தின் README கோப்புகளை படிக்கவும் +4. https://ff-quizzes.netlify.app/web/ இல் பாடத்திற்கு முந்தைய வினாடி பரீட்சைகளை முடிக்கவும் +5. பாட அடைவுகளில் குறியீடு எடுத்துக்காட்டுகளுக்கு வேலை செய்யவும் +6. பணிகள் மற்றும் சவால்களை முடிக்கவும் +7. பாடத்திற்கு பிறகு வினாடி பரீட்சைகள் எடுக்கவும் -### Live Development +### நேரடி அபிவிருத்தி -- **ஆவணங்கள்**: ரூட் கோப்புறையில் `docsify serve` இயக்கவும் (போர்ட் 3000) -- **Quiz App**: quiz-app கோப்புறையில் `npm run dev` இயக்கவும் -- **திட்டங்கள்**: HTML திட்டங்களுக்கு VS Code Live Server நீட்டிப்பை பயன்படுத்தவும் -- **API திட்டங்கள்**: தொடர்புடைய API அடைவுகளில் `npm start` இயக்கவும் +- **ஆவணங்கள்**: ரூட் வழியில் `docsify serve` ஐ ஓட்டவும் (போர்ட் 3000) +- **Quiz App**: quiz-app அடைவில் `npm run dev` ஓட்டவும் +- **திட்டங்கள்**: HTML திட்டங்களுக்கு VS Code Live Server விரிவுருவைப் பயன்படுத்தவும் +- **API திட்டங்கள்**: தொடர்புடைய API அடைவுகளில் `npm start` ஓட்டவும் -## Testing Instructions +## சோதனைக்கான வழிமுறைகள் -### Quiz App Testing +### Quiz App சோதனை ```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` இயக்கவும் -- markdown இணைப்புகள் செல்லுபடியானவையாக உள்ளதா உறுதிசெய்யவும் -- குறியீடு உதாரணங்களை ப்ரௌசர் அல்லது 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 +### மார்க்டவுன் ஆவணங்கள் - தெளிவான தலைப்பு வரிசை -- மொழி குறிப்பிடப்பட்ட குறியிடு தொகுதிகள் -- கூடுதல் வளங்களுக்கு இணைப்புகள் -- `images/` அடைவுகளில் படங்கள் மற்றும் ஸ்கிரீன்ஷாட்கள் -- அணுகல் வசதிக்கு படங்களுக்கான மாற்று உரை +- மொழி குறிப்பிடப்பட்ட குறியீடு கட்டங்கள் +- கூடுதல் வளங்களுக்கான இணைப்புகள் +- `images/` அடைவுகளில் திரைபடங்கள் மற்றும் புகைப்படங்கள் +- அணுகுதல் வசதிக்கான படங்களுக்கான Alt உரை -### File Organization +### கோப்பு அமைப்பு -- பாடங்கள் தொடர் எண்களுடன் (1-getting-started-lessons, 2-js-basics, மற்றும் மற்றவை) -- ஒவ்வொரு திட்டத்திற்கும் `solution/` மற்றும் பெரும்பாலும் `start/` அல்லது `your-work/` அடைவுகள் -- படங்கள் பாடசாலை-சிறப்பு `images/` கோப்புறைகளில் -- மொழிபெயர்ப்புகள் `translations/{language-code}/` கட்டமைப்பில் +- பாடங்கள் தொடர்ச்சியாக எண்கள் (1-getting-started-lessons, 2-js-basics, முதலியன) +- ஒவ்வொரு திட்டத்திற்கும் `solution/` மற்றும் பெரும்பாலும் `start/` அல்லது `your-work/` அடைவுகள் உள்ளன +- பாட அதிகாரமான `images/` அடைவுகளில் படங்கள் சேமிக்கப்படுகின்றன +- மொழிபெயர்ப்புகள் `translations/{language-code}/` கட்டமைப்பில் உள்ளன -## Build and Deployment +## கட்டுமானம் மற்றும் வழங்கல் -### Quiz App Deployment (Azure Static Web Apps) +### Quiz App வழங்கல் (Azure Static Web Apps) -quiz-app Azure Static Web Apps பரவலுக்காக கட்டமைக்கப்பட்டுள்ளது: +quiz-app ஐ Azure Static Web Apps வழங்கலுக்காக கட்டமைக்கப்பட்டுள்ளது: ```bash cd quiz-app npm run build # dist/ கோப்புறையை உருவாக்குகிறது -# main கிளையில் push செய்தவுடன் GitHub Actions வேலைப்பாட்டினால் பரப்புகிறது +# மெயின் கிளையில் புஷ் செய்தபோது GitHub செயலிகள் வேலைப்பாட்டின் மூலம் வெளியிடுகிறது ``` Azure Static Web Apps கட்டமைப்பு: -- **App இடம்**: `/quiz-app` -- **வெளியீட்டு இடம்**: `dist` +- **ஆப் இடம்**: `/quiz-app` +- **வெளியீட்டிடம்**: `dist` - **பணிச்சூழல்**: `.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 # docs இலிருந்து PDF உருவாக்குக ``` -### Docsify Documentation +### Docsify ஆவணங்கள் ```bash -npm install -g docsify-cli # Docsify ஐ உலகளாவியமாக நிறுவு -docsify serve # localhost:3000 இல் சேவை செய்யவும் +npm install -g docsify-cli # Docsify-ஐ உலகளாவிய முறையில் நிறுவவும் +docsify serve # localhost:3000-ல் சேவை செய்யவும் ``` -### Project-specific Builds +### திட்ட குறிப்பிட்ட கட்டமைப்புகள் -ஒவ்வொரு திட்ட அடைவு தனிப்பட்ட கட்டுமான செயலியை கொண்டிருக்கும்: -- Vue திட்டங்கள்: `npm run build` மூலம் உற்பத்தி தொகுப்புகள் உருவாக்கப்படுகின்றன -- நிலையான (Static) திட்டங்கள்: கட்டுமான படி இல்லை, கோப்புகளை நேரடியாக வழங்குங்கள் +ஒவ்வொரு திட்ட அடைவுக்கும் தனித்த கட்டுமான செயல்முறை இருக்கலாம்: +- Vue திட்டங்கள்: `npm run build` மூலம் உற்பத்தி தொகுதிகள் உருவாகின்றன +- நிலையான திட்டங்கள்: கட்டுமான படி இல்லை, கோப்புகளை நேரடியாக வழங்கவும் -## Pull Request Guidelines +## Pull Request வழிகாட்டிகள் -### Title Format +### தலைப்பு வடிவமைப்பு -மாற்ற இடத்தை வெளிப்படுத்தும் தெளிவான தலைப்புகளைப் பயன்படுத்தவும்: -- `[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` +மாற்றப் பகுதிகளைக் காட்டும் தெளிவான விளக்க தலைப்புகளைப் பயன்படுத்தவும்: +- `[Quiz-app] பாடம் X க்கான புதிய வினாடி தேர்வு சேர்க்கவும்` +- `[Lesson-3] Terrarium திட்டத்தில் பிழை திருத்தம்` +- `[Translation] பாடம் 5 க்கான ஸ்பானிஷ் மொழிபெயர்ப்பு சேர்க்கவும்` +- `[Docs] அமைப்புத் தகவலை புதுப்பிக்கவும்` -### Required Checks +### தேவையான சோதனைகள் -PR சமர்ப்பிக்கும் முன்: +PR சமர்ப்பிப்பதற்கு முன்: 1. **குறியீடு தரம்**: - - பாதிக்கப்பட்ட திட்ட அடைவுகளில் `npm run lint` இயக்கவும் - - அனைத்து lint பிழைகளும் மற்றும் எச்சரிக்கைகளும் சரி செய்யவும் + - பாதிப்படைந்த திட்ட அடைவுகளில் `npm run lint` ஓட்டவும் + - அனைத்து lint பிழைகள் மற்றும் எச்சரிக்கைகளை சரிசெய்யவும் -2. **கட்டுமான சோதனை**: - - பொருத்தப்பட்டால் `npm run build` இயக்கவும் - - எந்தவொரு கட்டுமான பிழைகளும் இல்லாமல் உறுதிசெய்யவும் +2. **கட்டுமான சரிபார்ப்பு**: + - பொருந்தும் பட்சத்தில் `npm run build` ஓட்டவும் + - கட்டுமான பிழைகள் இல்லாமல் உறுதி செய்யவும் -3. **இணைப்புக் சரிபார்ப்பு**: - - அனைத்து markdown இணைப்புகளும் செயலில் உள்ளனவா சோதிக்கவும் - - படம் குறிப்பு வேலை செய்வதை உறுதிசெய்யவும் +3. **இணைப்பு சரிபார்ப்பு**: + - அனைத்து மார்க்டவுன் இணைப்புகளையும் சோதிக்கவும் + - பட தொடர்புகளைச் சரி பார்த்தல் 4. **உள்ளடக்கம் ஆய்வு**: - - உச்சரிப்பு மற்றும் இலக்கியத்திற் கூர்மையுடன் பரிசீலனை செய்ய - - குறியீடு உதாரணங்கள் சரியான மற்றும் கல்வி நுட்பமானவையாயிருக்க வேண்டும் - - மொழிபெயர்ப்புகள் அசல் அர்த்தத்தை சரியாக பராமரிக்கின்றனவா என உறுதிசெய்யவும் + - ஒழுங்குமுறை மற்றும் இலக்கணப்பிழைகள் சரிபார்க்கவும் + - குறியீடு எடுத்துக்காட்டுகள் சரியானதும் கல்விக்குரியதும் என்பதை உறுதி செய்யவும் + - மொழிபெயர்ப்புகள் மூல அர்த்தத்தை கட்டாயப்படுத்துதல் -### Contribution Requirements +### பங்கேற்றும் நிபந்தனைகள் -- Microsoft CLAக்கு ஒப்புதல் (முதல் PR இல் தானாக சோதனை) +- Microsoft CLA (முதல் PR இல் தானாகச் சரிபார்த்தல்) உடன் ஒப்பந்தமடையவும் - [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) பின்பற்றவும் -- விரிவான வழிகாட்டலுக்கு [CONTRIBUTING.md](./CONTRIBUTING.md) பார்க்கவும் -- PR விளக்கத்தில் தேவையானால் குறுந்தகடு எண்ணிக்கைகளை குறிப்பிடவும் +- விவரமுள்ள வழிகாட்டிகளுக்கு [CONTRIBUTING.md](./CONTRIBUTING.md) பார்க்கவும் +- PR விவரத்தில் சம்பந்தப்பட்ட விளக்க இலக்கங்களை குறிப்பிட்டு -### Review Process +### ஆய்வுப் பணிகள் -- PRகள் பராமரிப்பவர்களும் சமுதாயமும் மதிப்பாய்வு செய்கின்றனர் -- கல்வி தெளிவுக்கு முக்கியத்துவம் கொடுக்கப்படுகிறது -- குறியீடு உதாரணங்கள் தற்போதைய சிறந்த நடைமுறைகளை பின்பற்ற வேண்டும் -- மொழிபெயர்ப்புகள் துல்லியமும், பண்பாட்டு பொருத்தமும் கொண்டதாக மதிப்பாய்வதன் கீழ் உள்ளன +- PR க்கள் பராமரிப்பாளர்களாலும் சமுதாயத்தாலும் மதிப்பாய்வு செய்யப்படுகின்றன +- கல்வி தெளிவு முக்கியமாக எடுத்துக்கொள்ளப்படுகிறது +- குறியீடு எடுத்துக்காட்டுகள் தற்போதைய சிறந்த நடைமுறைகளை பின்பற்ற வேண்டும் +- மொழிபெயர்ப்புகள் துல்லியமாகவும், கலாச்சாரத்திற்கு ஏற்பவையாகவும் இருக்க வேண்டும் -## Translation System +## மொழி மாற்ற அமைப்பு -### Automated Translation +### தானியங்கி மொழிபெயர்ப்பு -- GitHub Actions உடன் co-op-translator பணிசூழலைப் பயன்படுத்துகிறது -- 50+ மொழிகளுக்கு தானாக மொழிபெயர்க்கின்றது -- மூல கோப்புகள் பிரதான அடைவுகளில் உள்ளன +- 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 ``` -## 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 சரியான வடிவத்தில் உள்ளது என்பதை உறுதி செய்யவும் +- உலாவி கன்சோலில் பிழைகள் உள்ளதா பாருங்கள் +- உலாவி-தனித்துவப்பட்ட விரிவுரு நிறுவல் வழிகாட்டல்களை பின்பற்றவும் **Python chat திட்ட பிரச்சினைகள்**: -- OpenAI பேக்கேஜ் நிறுவப்பட்டுள்ளது என உறுதிசெய்யவும்: `pip install openai` -- GITHUB_TOKEN சுற்றுச்சூழல் மாறி அமைக்கப்பட்டுள்ளது என சரிபார்க்கவும் -- GitHub Models அணுகல் அனுமதிகள் சரிபார்க்கவும் +- 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 நீட்டிப்பை பயன்படுத்தவும் -- ஒழுங்குபடுத்த நிலையான ESLint மற்றும் Prettier நீட்டிப்புகளை நிறுவவும் -- JavaScript பிழைத்திருத்தத்திற்கு ப்ரௌசர் DevTools பயன்படுத்தவும் -- Vue திட்டங்களுக்கு Vue DevTools ப்ரௌசர் நீட்டிப்பை நிறுவவும் +- HTML திட்டங்களுக்கு VS Code Live Server விரிவுருவைக பயன்படுத்தவும் +- எழுத்து ஒற்றுமைக்காக ESLint மற்றும் Prettier விரிவுருக்களை நிறுவவும் +- JavaScript பிழைத்திருத்தத்திற்கான உலாவி DevTools ஐ பயன்படுத்தவும் +- Vue திட்டங்களுக்கு Vue DevTools உலாவி விரிவுருவை நிறுவவும் -### Performance Considerations +### செயல்திறன் கருத்துக்கள் -- மொழிபெயர்க்கப்பட்ட கோப்புகளின் பெரும் தொகை (50+ மொழிகள்) முழு கிளோன்கள் பெரியதாக இருக்கின்றன -- உள்ளடக்கத்தில் மட்டுமே வேலை செய்ய shallow clone பயன்படுத்தவும்: `git clone --depth 1` -- ஆங்கில உள்ளடக்கத்தில் வேலை செய்வ போது மொழிபெயர்ப்புகளை தேடலில் இருந்து விலக்கு -- முதல் முறையும் npm install மற்றும் Vite build போன்ற கட்டுமான செயலிகள் மெதுவாக இயங்கலாம் +- மொழிபெயர்க்கப்பட்ட கோப்புகளின் அதிக எண்ணிக்கை (50+ மொழிகள்) அதிகமான பையில் பெரிதாக இருக்கும் +- உள்ளடக்கத்தில் மட்டுமே பணியாற்ற shallow clone பயன்படுத்தவும்: `git clone --depth 1` +- ஆங்கில உள்ளடக்க பணியாற்றும்போது மொழிபெயர்ப்புகளை தேடலிலிருந்து தவிர்க்கவும் +- முதல் ஓட்டத்தில் கட்டுமான செயல்முறைகள் மந்தமாக இருக்கலாம் (npm install, Vite build) -## Security Considerations +## பாதுகாப்பு கருத்துகள் -### Environment Variables +### சுற்றுச்சூழல் மாறிகள் -- API விசைகள் ஒருபோதும் களஞ்சியத்தில் சேர்க்கப்பட கூடாது -- `.env` கோப்புகளை பயன்படுத்தவும் (ஈடுபாடுகள் `.gitignore`ல் உள்ளன) -- தேவையான சுற்றுச்சூழல் மாறிகள் திட்ட READMEகளில் ஆவணப்படுத்தப்பட்டுள்ளது +- API விசைகள் சேமிப்பகத்தில் ஒருபோதும் பதியப்படக் கூடாது +- `.env` கோப்புகளை பயன்படுத்தவும் (ஏற்கனவே `.gitignore` இல் உள்ளது) +- தேவையான சுற்றுச்சூழல் மாறிகள் திட்ட READMEல் ஆவணம் செய்யவும் -### Python Projects +### Python திட்டங்கள் -- மெய்நிகர் சுற்றுச்சூழல்கள் பயன்படுத்தவும்: `python -m venv venv` -- சார்புப் பொருள் பண்புகளை புதுப்பித்து வைக்கவும் -- GitHub டோக்கன்கள் குறைந்தபட்ச உரிமைகளுடன் இருக்க வேண்டும் +-மெய்நிகர் சூழல்களைப் பயன்படுத்தவும்: `python -m venv venv` +- சார்ந்த பொருட்களை இப்போதுபோல் மேம்படுத்தவும் +- GitHub டோக்கன்களுக்கு குறைந்தபட்ச அனுமதிகளை வழங்கவும் -### GitHub Models Access +### GitHub Models அணுகல் -- GitHub Modelsக்கு தனிப்பட்ட அணுகல் டோக்கன்கள் (PAT) தேவை -- டோக்கன்களை சுற்றுச்சூழல் மாறிகளாக சேமிக்கவும் -- டோக்கன்கள் அல்லது கடவுச்சொற்கள் ஒருபோதும் commit செய்ய கூடாது +- GitHub Models க்கான தனிப்பட்ட அணுகல் டோக்கன்கள் (PAT) தேவையானவை +- டோக்கன்கள் சுற்றுச்சூழல் மாறிகள் ஆகச் சேமிக்கப்பட வேண்டும் +- ஒருபோதும் டோக்கன்கள் அல்லது ஆதாரங்களைக் கமிட் செய்யாதீர்கள் -## 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) கற்றலாளர்களுக்கு பரிந்துரைக்கப்படுகிறது +- கற்றல் கூட உள்ளது என பரிந்துரைக்கப்பட்டது [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) - கூடுதல் பாடநெறிகள்: Generative AI, Data Science, ML, IoT பாடத்திட்டங்கள் கிடைக்கின்றன -### Working with Specific Projects +### குறிப்பிட்ட திட்டங்களுடன் பணியாற்றல் -தனித்தனிப் திட்டங்களுக்கான விரிவான விபரங்களுக்கு, கீழ்கண்ட README கோப்புகளைக் காணவும்: -- `quiz-app/README.md` - Vue 3 வினாடி வினா பயன்பாடு -- `7-bank-project/README.md` - அங்கீகாரம் கொண்ட வங்கிக் கூட்டான செயலி -- `5-browser-extension/README.md` - ப்ரௌசர் நீட்சிகள் மேம்பாடு -- `6-space-game/README.md` - கேன்வாஸ் அடிப்படையிலான விளையாட்டு மேம்பாடு -- `9-chat-project/README.md` - AI உரையாடல் உதவியாளர் திட்டம் +தனிப்பட்ட திட்டங்களுக்கான விரிவான வழிமுறைகள் கீழ்காணும் README கோப்புகளில் உள்ளன: +- `quiz-app/README.md` - Vue 3 வினாடி தேர்வு பயன்பாடு +- `7-bank-project/README.md` - அங்கீகாரத்துடன் வங்கி பயன்பாடு +- `5-browser-extension/README.md` - உலாவி விரிவுரு அபிவிருத்தி +- `6-space-game/README.md` - புலம் பொருத்த வண்ண கேம் அபிவிருத்தி +- `9-chat-project/README.md` - AI அரட்டை உதவியாளர் திட்டம் -### Monorepo Structure +### மொனோரெபோ கட்டமைப்பு -சாதாரணமான மொனோரெப்போ அல்லாவிட்டாலும், இந்த களஞ்சியம் பல தனித்தாண்டு திட்டங்களை கொண்டுள்ளது: -- ஒவ்வொரு பாடமும் தனிப்பட்டதாக உள்ளது -- திட்டங்கள் சார்பு பகிர்ந்து கொள்ளவில்லை -- தனிநபர் திட்டங்களில் வேலை செய்து மற்றவர்களுக்கு பாதிப்பிடாமல் செயல் படுத்தலாம் -- முழு பாடத்திட்ட அனுபவத்துக்கு முழு களஞ்சியத்தை கிளோன் செய்யவும் +இது பாரம்பரிய மொனோரெபோ அல்ல, பல தனித்தனிப் திட்டங்களை கொண்டுள்ளது: +- ஒவ்வொரு பாடமும் தனித்துள்ளதுமானது +- திட்டங்கள் சார்ந்த பொருட்கள் பகிர்ந்து கொள்ளப்படாது +- ஒருங்கிணைந்ததாக இல்லாமல் தனி தனி திட்டங்களில் பணியாற்றலாம் +- முழு பாடத்திட்ட அனுபவத்திற்காக முழுக் களஞ்சியத்தை கிளோன் செய்யலாம் --- -**வெளியீட்டு குறிப்புரை**: -இந்த ஆவணம் [Co-op Translator](https://github.com/Azure/co-op-translator) என்ற AI மொழிபெயர்ப்பு சேவையைப் பயன்படுத்தி மொழிபெயர்க்கப்பட்டுள்ளது. நாங்கள் துல்லியத்திற்காக முயற்சி செய்கிறோம் என்றாலும், தானியங்கி மொழிபெயர்ப்புகளில் தவறுகள் அல்லது பிழைகள் இருக்கக்கூடும் என்பதை தயவுசெய்து கவனத்தில் கொள்ளவும். அசல் ஆவணம் அதன் சொந்த மொழியில் அதிகாரப்பூர்வமான மூலமாகக் கருதப்பட வேண்டும். முக்கியமான தகவல்களுக்கு, தொழில்முறை மனித மொழிபெயர்ப்பை பரிந்துரைக்கிறோம். இந்த மொழிபெயர்ப்பின் பயன்பாட்டால் ஏற்படும் எந்த தவறான புரிதல்கள் அல்லது தவறான விளக்கங்களுக்கு நாங்கள் பொறுப்பானவர்கள் அல்ல. +**குறிப்புரை**: +இந்த ஆவணம் AI மொழிபெயர்ப்பு சேவை [Co-op Translator](https://github.com/Azure/co-op-translator) மூலம் மொழிபெயர்க்கப்பட்டுள்ளது. நாங்கள் துல்லியத்தைக் காத்திருக்கிறோம் என்றாலும், தானாக செய்யப்பட்ட மொழிபெயர்ப்புகளில் பிழைகள் அல்லது தவறுகள் இருக்க வாய்ப்பு உண்டு என்பதை தயவுசெய்து கவனத்தில் கொள்ளவும். மூல ஆவணம் அதன் தாய்மொழியில் அதிகாரபூர்வ ஆவணமாக கருதப்பட வேண்டும். முக்கியமான தகவல்களுக்கு, தொழில்முறை மனித மொழிபெயர்ப்பாளர் மூலம் மொழிபெயர்ப்பு செய்ய பரிந்துரைக்கப்படுகிறது. இந்த மொழிபெயர்ப்பின் பயன்பாட்டினால் ஏற்படும் எந்தவொரு தவறுதலும் அல்லது தவறான புரிதலுக்குமான பொறுப்பேற்க நாங்கள் முன்வரமாட்டோம். \ No newline at end of file diff --git a/translations/uk/.co-op-translator.json b/translations/uk/.co-op-translator.json index 7e3b14944..504877435 100644 --- a/translations/uk/.co-op-translator.json +++ b/translations/uk/.co-op-translator.json @@ -493,7 +493,7 @@ }, "AGENTS.md": { "original_hash": "a362efd06d64d4134a0cfe8515a86d34", - "translation_date": "2026-02-06T10:25:43+00:00", + "translation_date": "2026-02-06T12:06:35+00:00", "source_file": "AGENTS.md", "language_code": "uk" }, diff --git a/translations/uk/AGENTS.md b/translations/uk/AGENTS.md index 4b997eb59..bdd1f9271 100644 --- a/translations/uk/AGENTS.md +++ b/translations/uk/AGENTS.md @@ -1,28 +1,28 @@ # AGENTS.md -## Огляд проєкту +## Огляд проекту -Це навчальний репозиторій з навчальною програмою для початківців з основ веб-розробки. Програма є комплексним 12-тижневим курсом, розробленим спеціалістами Microsoft Cloud Advocates, що включає 24 практичні уроки, охоплюючи JavaScript, CSS та HTML. +Це репозиторій з навчальною програмою для вивчення основ веб-розробки для початківців. Програма — це всеосяжний 12-тижневий курс, розроблений Microsoft Cloud Advocates, який включає 24 практичних уроки з JavaScript, CSS та HTML. -### Ключові компоненти +### Основні компоненти - **Навчальний контент**: 24 структуровані уроки, організовані у модулі на основі проєктів -- **Практичні проєкти**: Терраріум, Гра на друку, Розширення браузера, Космічна гра, Банківський додаток, Редактор коду та AI-чат асистент -- **Інтерактивні тести**: 48 тестів по 3 питання в кожному (до і після уроку) -- **Підтримка багатьох мов**: Автоматичний переклад більш ніж на 50 мов за допомогою GitHub Actions +- **Практичні проєкти**: Тераріум, Гра на друкування, Розширення браузера, Космічна гра, Банківський додаток, Редактор коду та AI чат-асистент +- **Інтерактивні вікторини**: 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) -- Документація сервісується через Docsify і доступна у форматі PDF +- Кожна папка уроку містить README, приклади коду та рішення +- Окремі проєкти у власних каталогах (quiz-app, різні проекти уроків) +- Система перекладів за допомогою GitHub Actions (co-op-translator) +- Документація подається через Docsify і доступна у форматі PDF ## Команди налаштування -Цей репозиторій призначений здебільшого для споживання навчального контенту. Для роботи з окремими проєктами: +Цей репозиторій призначено головним чином для споживання навчального контенту. Для роботи з конкретними проектами: ### Основне налаштування репозиторію @@ -31,35 +31,35 @@ git clone https://github.com/microsoft/Web-Dev-For-Beginners.git cd Web-Dev-For-Beginners ``` -### Налаштування додатку Quiz (Vue 3 + Vite) +### Налаштування Quiz App (Vue 3 + Vite) ```bash cd quiz-app npm install npm run dev # Запустити сервер розробки -npm run build # Зібрати для продакшн +npm run build # Зібрати для виробництва npm run lint # Запустити ESLint ``` -### 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 +npm run format # Форматувати за допомогою Prettier ``` -### Проєкти розширень браузера +### Проекти розширення браузера ```bash cd 5-browser-extension/solution npm install -# Дотримуйтесь інструкцій завантаження розширень, специфічних для браузера +# Дотримуйтеся інструкцій із завантаження розширень, специфічних для браузера ``` -### Проєкти космічної гри +### Проекти космічної гри ```bash cd 6-space-game/solution @@ -67,7 +67,7 @@ npm install # Відкрийте index.html у браузері або використовуйте Live Server ``` -### Проєкт чату (бекенд на Python) +### Чат-проєкт (Python Backend) ```bash cd 9-chat-project/solution/backend/python @@ -76,33 +76,33 @@ pip install openai python api.py ``` -## Робочий процес розробки +## Розробницький процес -### Для авторів контенту +### Для контрибуторів контенту -1. **Сфокуйте репозиторій** у свій акаунт GitHub +1. **Форкніть репозиторій** у вашому обліковому записі GitHub 2. **Склонуйте свій форк** локально -3. **Створіть нову гілку** для змін -4. Вносьте зміни у навчальний контент або приклади коду -5. Перевіряйте зміни коду у відповідних директоріях проєктів -6. Відправляйте pull-запити відповідно до інструкцій з внеску +3. **Створіть нову гілку** для ваших змін +4. Внесіть зміни до контенту уроків або прикладів коду +5. Тестуйте зміни коду у відповідних каталогах проєктів +6. Надсилайте pull request відповідно до інструкцій з внеску ### Для учнів -1. Форкуйте або клоньте репозиторій -2. Послідовно переходьте у папки уроків -3. Читайте README файли кожного уроку -4. Пройдіть тести перед уроком на https://ff-quizzes.netlify.app/web/ +1. Форкіть або склонуйте репозиторій +2. Перейдіть послідовно до каталогів уроків +3. Читайте README файли для кожного уроку +4. Виконуйте вікторини перед уроком на https://ff-quizzes.netlify.app/web/ 5. Працюйте з прикладами коду у папках уроків 6. Виконуйте завдання і виклики -7. Пройдіть тести після уроку +7. Пройдіть вікторини після уроку -### Жива розробка +### Живий розвиток - **Документація**: Запустіть `docsify serve` у корені (порт 3000) -- **Quiz App**: Запустіть `npm run dev` у директорії quiz-app -- **Проєкти**: Використовуйте розширення Live Server у VS Code для HTML проєктів -- **API проєкти**: Запускайте `npm start` у відповідних API директоріях +- **Quiz App**: Запустіть `npm run dev` у папці quiz-app +- **Проекти**: Використовуйте розширення VS Code Live Server для HTML проектів +- **API-проекти**: Запустіть `npm start` у відповідних каталогах API ## Інструкції для тестування @@ -118,33 +118,33 @@ npm run build # Переконайтеся, що збірка успішн ```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, де налаштовано @@ -152,127 +152,127 @@ node server.js # Перевірте, чи сервер запускаєть - Семантичні елементи HTML5 - Принципи адаптивного дизайну -- Чіткі угоди щодо найменування класів -- Коментарі, що пояснюють CSS прийоми для учнів +- Чіткі конвенції найменування CSS-класів +- Коментарі, що пояснюють CSS-техніки для учнів ### Python -- Керівництво стилю PEP 8 -- Зрозумілі, навчальні приклади коду -- Використання типізації там, де це допомагає у навчанні +- Дотримання керівництва зі стилю PEP 8 +- Зрозумілі навчальні приклади коду +- Підказки типів, де це корисно для навчання ### Документація Markdown - Чітка ієрархія заголовків -- Блоки коду зі вказівкою мови +- Блоки коду з вказівкою мови - Посилання на додаткові ресурси -- Знімки екрану та зображення у папках `images/` -- Вказівка альтернативного тексту для доступності +- Скриншоти та зображення в папках `images/` +- Альтернативний текст для зображень для доступності ### Організація файлів -- Уроки нумеруються послідовно (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 workflow при пуші в main +# Розгортає через робочий процес GitHub Actions при пуші до main ``` Конфігурація Azure Static Web Apps: - **Розташування додатку**: `/quiz-app` -- **Вихідне розташування**: `dist` -- **Робочий процес**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` +- **Розташування виводу**: `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 run convert # Згенерувати PDF з docs ``` -### Документація 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] Виправити помилку у проєкті терраріум` -- `[Translation] Додати іспанський переклад для уроку 5` +Використовуйте чіткі, описові назви, що вказують на сферу змін: +- `[Quiz-app] Додати нову вікторину для уроку X` +- `[Lesson-3] Виправити друкарську помилку в проєкті terrarium` +- `[Translation] Додати іспанський переклад уроку 5` - `[Docs] Оновити інструкції з налаштування` -### Обов’язкові перевірки +### Необхідні перевірки -Перед відправкою PR: +Перед надсиланням PR: 1. **Якість коду**: - - Запустіть `npm run lint` у відповідних директоріях - - Виправте всі помилки і попередження lint + - Запустіть `npm run lint` у відповідних проектах + - Виправте всі помилки і застереження лінтера 2. **Перевірка збірки**: - - Запустіть `npm run build` якщо застосовно - - Переконайтеся у відсутності помилок збірки + - Запустіть `npm run build` за потребою + - Переконайтесь у відсутності помилок збірки 3. **Перевірка посилань**: - - Перевірте всі markdown-посилання - - Переконайтеся, що посилання на зображення працюють + - Тестуйте всі markdown-посилання + - Переконайтесь, що посилання на зображення працюють 4. **Перевірка контенту**: - - Вичитка на орфографію і граматику - - Переконатися у коректності і навчальній цінності прикладів коду - - Перевірити відповідність перекладів оригінальному змісту + - Коректність орфографії і граматики + - Правильність та навчальна цінність прикладів коду + - Переклади збережені точно і відповідно ### Вимоги до внеску -- Погодитись з Microsoft CLA (автоматична перевірка при першому PR) -- Дотримуватись [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) -- Ознайомитись з [CONTRIBUTING.md](./CONTRIBUTING.md) для детальних інструкцій -- Вказувати номера issue у описі PR, якщо застосовно +- Підпишіться під Microsoft CLA (автоматична перевірка при першому PR) +- Дотримуйтесь [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/) +- Див. [CONTRIBUTING.md](./CONTRIBUTING.md) для детальних вказівок +- Посилайтесь на номери issue у описі PR, якщо потрібно -### Процес перевірки +### Процес рев’ю -- PR перевіряються підтримувачами та спільнотою -- Пріоритет — зрозумілість навчального матеріалу +- PR переглядають мейнтейнерами і спільнотою +- Пріоритет — зрозумілість для навчання - Приклади коду мають відповідати найкращим практикам -- Переклади перевіряються на точність та культурну відповідність +- Переклади перевіряються на точність і культурну доречність -## Система перекладу +## Система перекладів ### Автоматичний переклад -- Використовує GitHub Actions з робочим процесом co-op-translator -- Перекладає автоматично на понад 50 мов -- Файли джерела знаходяться у основних директоріях -- Перекладені файли знаходяться у `translations/{language-code}/` +- Використовує GitHub Actions з workflow co-op-translator +- Автоматично перекладає на 50+ мов +- Джерельні файли у головних каталогах +- Переклади у папках `translations/{language-code}/` -### Додавання ручних покращень перекладу +### Додавання покращень вручну 1. Знайдіть файл у `translations/{language-code}/` 2. Вносьте покращення, зберігаючи структуру -3. Переконайтесь, що приклади коду залишаються робочими -4. Протестуйте будь-який локалізований тестовий контент +3. Переконайтесь, що приклади коду працюють +4. Тестуйте локалізований контент вікторин ### Метадані перекладу @@ -289,120 +289,120 @@ 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` +- Перевірте, що версія Node.js відповідає мінімуму (node >=10) +- Переконайтесь, що порт не зайнятий +- Всі залежності встановлено за допомогою `npm install` **Розширення браузера не завантажується**: - Перевірте правильність форматування manifest.json -- Перевірте консоль браузера на помилки -- Дотримуйтесь інструкцій з встановлення розширень для конкретного браузера +- Подивіться консоль браузера на наявність помилок +- Дотримуйтесь інструкцій по встановленню для конкретного браузера -**Проблеми з чат-проєктом на Python**: -- Переконайтесь, що пакет OpenAI встановлений: `pip install openai` -- Перевірте змінну середовища GITHUB_TOKEN -- Переконайтеся у наявності прав доступу до GitHub Models +**Проблеми з Python чат-проєктом**: +- Переконайтесь, що встановлено пакет OpenAI: `pip install openai` +- Задано змінну середовища GITHUB_TOKEN +- Перевірте права доступу до GitHub Models -**Docsify не сервить документацію**: +**Docsify не подає документацію**: - Встановіть docsify-cli глобально: `npm install -g docsify-cli` -- Запускайте з кореневої директорії репозиторію -- Перевірте наявність файлу `docs/_sidebar.md` +- Запускайте з кореневого каталогу репозиторію +- Переконайтеся, що існує `docs/_sidebar.md` -### Поради для середовища розробки +### Поради щодо середовища розробки -- Використовуйте VS Code з розширенням Live Server для HTML проєктів -- Встановіть розширення ESLint і Prettier для консистентного форматування -- Використовуйте DevTools браузера для відлагодження JavaScript -- Для Vue проєктів встановіть Vue DevTools розширення для браузера +- Використовуйте VS Code з розширенням Live Server для HTML проектів +- Встановіть ESLint і Prettier для узгодженого форматування +- Використовуйте DevTools браузера для налагодження JavaScript +- Для Vue-проєктів встановіть Vue DevTools розширення для браузера -### Розгляди ефективності +### Питання продуктивності -- Велика кількість перекладених файлів (понад 50 мов) робить повні клонування великими +- Велика кількість перекладених файлів (50+ мов) робить повні клонування великими - Використовуйте shallow clone, якщо працюєте лише з контентом: `git clone --depth 1` -- Виключайте переклади з пошуку при роботі з англійським вмістом -- Процеси збірки можуть бути повільними під час першого запуску (npm install, збірка Vite) +- Виключайте переклади з пошуку, коли працюєте з англійським контентом +- Процеси збірки можуть бути повільними при першому запуску (npm install, збірка Vite) -## Розгляди безпеки +## Розгляд питань безпеки ### Змінні середовища -- API ключі ніколи не повинні додаватися в репозиторій -- Використовуйте `.env` файли (вже додані у `.gitignore`) -- Документуйте необхідні змінні середовища у README проєктів +- Ключі API НЕ слід комітити у репозиторій +- Використовуйте `.env` файли (вже в `.gitignore`) +- Документуйте необхідні змінні середовища в README проєктів ### Python проєкти - Використовуйте віртуальні середовища: `python -m venv venv` -- Підтримуйте залежності оновленими -- Токени GitHub повинні мати мінімальні потрібні дозволи +- Тримайте залежності оновленими +- Токени GitHub повинні мати мінімально потрібні права ### Доступ до GitHub Models -- Для GitHub Models потрібні Personal Access Tokens (PAT) -- Токени повинні зберігатися у змінних середовища -- Ніколи не додавайте токени або облікові дані в репозиторій +- Для GitHub Models потрібні Персональні Токени Доступу (PAT) +- Зберігайте токени як змінні середовища +- Ніколи не комітьте токени або облікові дані ## Додаткові нотатки ### Цільова аудиторія -- Повні початківці у веб-розробці -- Студенти та самостійні учні -- Викладачі, що використовують цей курс у класах -- Контент розроблений з урахуванням доступності і поступового розвитку навичок +- Абсолютні початківці у веб-розробці +- Студенти та самонавчальні особи +- Викладачі, які використовують програму у класах +- Контент розроблений з урахуванням доступності та поступового навчання ### Освітня філософія -- Проєктний підхід до навчання -- Часті перевірки знань (тести) +- Підхід навчання на основі проєктів +- Часті перевірки знань (вікторини) - Практичні вправи з кодування - Приклади застосування у реальному світі -- Фокус на основах перед вивченням фреймворків +- Орієнтованість на основи перед фреймворками ### Підтримка репозиторію -- Активна спільнота учнів і співпрацівників -- Регулярні оновлення залежностей та контенту -- Моніторинг issues і обговорень підтримувачами -- Автоматичне оновлення перекладів через GitHub Actions +- Активна спільнота учнів та контрибуторів +- Регулярне оновлення залежностей і контенту +- Моніторинг issues та обговорень підтримуючими +- Оновлення перекладів автоматизовано через GitHub Actions -### Супутні ресурси +### Пов’язані ресурси -- [Microsoft Learn modules](https://docs.microsoft.com/learn/) -- [Student Hub resources](https://docs.microsoft.com/learn/student-hub/) +- [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, дата саєнс, машинне навчання, 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](https://github.com/Azure/co-op-translator). Хоча ми прагнемо до точності, зверніть увагу, що автоматичні переклади можуть містити помилки або неточності. Оригінальний документ рідною мовою слід вважати авторитетним джерелом. Для важливої інформації рекомендується звертатися до професійного людського перекладу. Ми не несемо відповідальності за будь-які непорозуміння або неправильні тлумачення, що виникли внаслідок використання цього перекладу. +Цей документ було перекладено за допомогою сервісу автоматичного перекладу [Co-op Translator](https://github.com/Azure/co-op-translator). Хоча ми прагнемо до точності, будь ласка, майте на увазі, що автоматичні переклади можуть містити помилки або неточності. Оригінальний документ рідною мовою слід вважати авторитетним джерелом. Для критичної інформації рекомендується звертатися до професійного людського перекладу. Ми не несемо відповідальності за будь-які непорозуміння чи неправильне тлумачення, що виникли внаслідок використання цього перекладу. \ No newline at end of file