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

pull/1774/head
localizeflow[bot] 2 weeks ago
parent 3dd0c15c92
commit 9346676db1

@ -1,7 +1,7 @@
{
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8",
"translation_date": "2026-03-06T13:30:36+00:00",
"original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-27T20:25:34+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "bg"
},
@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T13:34:01+00:00",
"translation_date": "2026-03-27T20:35:22+00:00",
"source_file": "AGENTS.md",
"language_code": "bg"
},

@ -2,27 +2,27 @@
## Преглед на проекта
Това е учебен репозиторий за преподаване на основите на уеб разработката за начинаещи. Учебният план е цялостен 12-седмичен курс, разработен от Microsoft Cloud Advocates, съдържащ 24 практически урока, покриващи JavaScript, CSS и HTML.
Това е репозиториум с учебна учебна програма за преподаване на основите на уеб разработката за начинаещи. Учебната програма е изчерпателен 12-седмичен курс, разработен от Microsoft Cloud Advocates, включващ 24 практически урока, обхващащи JavaScript, CSS и HTML.
### Основни компоненти
### Ключови компоненти
- **Образователно съдържание**: 24 структурирани урока, организирани в проекти-базирани модули
- **Практически проекти**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor и AI Chat Assistant
- **Интерактивни куизове**: 48 куиза с по 3 въпроса всеки (оценка преди и след урока)
- **Поддръжка на много езици**: Автоматични преводи за 50+ езика чрез GitHub Actions
- **Образователно съдържание**: 24 структурирани урока, организирани в модули, базирани на проекти
- **Практически проекти**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, and 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)
- Документацията се обслужва чрез Docsify и е налична като PDF
- Образователен репозиториум със структура, базирана на уроци
- Всяка папка на урока съдържа README, примери с код и решения
- Самостоятелни проекти в отделни директории (quiz-app, различни проекти от уроците)
- Система за превод, използваща GitHub Actions (co-op-translator)
- Документация, обслужвана чрез Docsify и налична като PDF
## Команди за настройка
Този репозиторий е основно за консумация на образователно съдържание. За работа с конкретни проекти:
Този репозиториум е основно за консумация на образователно съдържание. За работа с конкретни проекти:
### Основна настройка на репозитория
@ -36,38 +36,38 @@ cd Web-Dev-For-Beginners
```bash
cd quiz-app
npm install
npm run dev # Стартиране на сървър за разработка
npm run build # Създаване на билд за продукция
npm run lint # Стартиране на ESLint
npm run dev # Стартирай сървър за разработка
npm run build # Изгради за продукция
npm run lint # Пусни ESLint
```
### API на Bank Project (Node.js + Express)
### API за банков проект (Node.js + Express)
```bash
cd 7-bank-project/api
npm install
npm start # Стартиране на API сървър
npm run lint # Стартиране на ESLint
npm run format # Форматиране с Prettier
npm start # Стартирай API сървър
npm run lint # Стартирай ESLint
npm run format # Форматирай с Prettier
```
### Проекти за Browser Extension
### Проекти за разширения за браузър
```bash
cd 5-browser-extension/solution
npm install
# Следвайте специфичните за браузъра инструкции за зареждане на разширения
# Следвайте инструкциите за зареждане на разширението, специфични за браузъра
```
### Проекти за Space Game
### Проекти за космическа игра
```bash
cd 6-space-game/solution
npm install
# Отворете index.html в браузър или използвайте Live Server
# Отворете index.html в браузъра или използвайте Live Server
```
### Chat Project (Python бекенд)
### Чат проект (Python бекенд)
```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 request-и според насоките за допринасяне
4. Направете промени в съдържанието на уроците или в примерите с код
5. Тествайте всякакви кодови промени в съответните директории на проектите
6. Изпратете pull request-ове, следвайки указанията за принос
### За учащите
1. Форкнете или клонирайте репозитория
2. Навигирайте последователно в папките с уроци
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
- **Проекти**: Използвайте разширението Live Server на VS Code за HTML проекти
- **API проекти**: Стартирайте `npm start` в съответните API директории
## Инструкции за тестване
@ -110,173 +110,171 @@ python api.py
```bash
cd quiz-app
npm run lint # Проверете за проблеми със стил на кода
npm run build # Потвърдете, че изграждането е успешно
npm run lint # Проверете за проблеми със стила на кода
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
- Уверете се, че преводите запазват правилната структура
- Тествайте примерите с код в браузър или Node.js
- Проверете, че преводите запазват правилната структура
## Насоки за стил на кода
### JavaScript
- Използвайте съвременен синтаксис ES6+
- Спазвайте стандартните ESLint конфигурации, предоставени в проектите
- Следвайте стандартните конфигурации на ESLint, предоставени в проектите
- Използвайте смислени имена на променливи и функции за образователна яснота
- Добавяйте коментари обясняващи концепциите за учащите
- Форматирайте с Prettier където е конфигуриран
- Добавяйте коментари, обясняващи концепциите за учащите
- Форматирайте с Prettier там, където е конфигуриран
### HTML/CSS
- Семантични HTML5 елементи
- Принципи на адаптивен дизайн
- Ясни наименования на класове
- Принципи за адаптивен дизайн
- Ясни конвенции за именуване на класове
- Коментари, обясняващи CSS техники за учащите
### Python
- Насоки за стил PEP 8
- Ясни, образователни кодови примери
- Типово обозначаване където е полезно за ученето
- Ясни, образователни примери с код
- Указания за типове (type hints), когато са полезни за обучението
### 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, etc.)
- Всеки проект има `solution/` и често `start/` или `your-work/` директории
- Изображенията се съхраняват в за урок-специфични `images/` папки
- Преводите в структура `translations/{language-code}/`
## Сглобяване и разгръщане
## Изграждане и разгръщане
### Разгръщане на Quiz App (Azure Static Web Apps)
quiz-app е конфигуриран за разгръщане в Azure Static Web Apps:
```bash
cd quiz-app
npm run build # Създава папка dist/
# Разгръща чрез GitHub Actions workflow при push към main
# Извършва разгръщане чрез workflow на GitHub Actions при push към клона main
```
Конфигурация за Azure Static Web Apps:
- **Местоположение на приложението**: `/quiz-app`
- **Изходна директория**: `dist`
- **Работен процес**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
Azure Static Web Apps конфигурация:
- **App location**: `/quiz-app`
- **Output location**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Генериране на PDF документация
### Генериране на документация в PDF
```bash
npm install # Инсталирайте docsify-to-pdf
npm run convert # Генерирайте PDF от docs
npm install # Инсталиране на docsify-to-pdf
npm run convert # Генериране на PDF от docs
```
### Документация с Docsify
```bash
npm install -g docsify-cli # Инсталирайте Docsify глобално
docsify serve # Стартирайте на localhost:3000
docsify serve # Стартирайте сървър на localhost:3000
```
### Сглобяване по проекти
### Проектно-специфични билдове
Всяка проектна директория може да има собствен процес на изграждане:
Всяка проектна директория може да има собствен процес за билд:
- Vue проекти: `npm run build` създава продукционни пакети
- Статични проекти: без стъпка за билд, обслужват файловете директно
- Статични проекти: Няма стъпка за изграждане, сервирайте файловете директно
## Насоки при pull request-и
## Насоки за Pull Requests
### Формат на заглавието
Използвайте ясни, описателни заглавия, указващи областта на промяната:
- `[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`
### Изисквани проверки
### Задължителни проверки
Преди подаване на PR:
Преди да изпратите PR:
1. **Качество на кода**:
1. **Качеството на кода**:
- Стартирайте `npm run lint` в засегнатите проектни директории
- Поправете всички грешки и предупреждения
- Поправете всички грешки и предупреждения от lint
2. **Проверка на билд**:
- Стартирайте `npm run build` ако е приложимо
- Уверете се, че няма грешки при билда
2. **Проверка на билда**:
- Стартирайте `npm run build`, ако е приложимо
- Уверете се, че няма грешки при билд
3. **Проверка на връзки**:
3. **Валидиране на връзки**:
- Тествайте всички markdown връзки
- Проверете дали изображенията се зареждат
- Проверете референциите към изображенията
4. **Преглед на съдържанието**:
- Коректура за правопис и граматика
- Уверете се, че кодовите примери са точни и образователни
- Проверката на преводите за запазване на оригиналния смисъл
- Коригирайте правописа и граматиката
- Уверете се, че примерите с код са правилни и образователни
- Потвърдете, че преводите запазват оригиналния смисъл
### Изисквания за допринасяне
### Изисквания за принос
- Съгласие с Microsoft CLA (автоматична проверка при първи PR)
- Спазвайте [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Вижте [CONTRIBUTING.md](./CONTRIBUTING.md) за подробни насоки
- Посочвайте номера на съществуващи проблеми в описанието на PR ако има такива
- Съгласете се с Microsoft CLA (автоматична проверка при първия PR)
- Следвайте [Кодекс за поведение с отворен код на Microsoft](https://opensource.microsoft.com/codeofconduct/)
- Вижте [CONTRIBUTING.md](./CONTRIBUTING.md) за подробни указания
- Посочете номера на issue-ите в описанието на PR, ако е приложимо
### Процес на преглед
- PR-овете се преглеждат от поддръжници и общността
- Приоритет е образователната яснота
- Кодови примери трябва да следват актуалните най-добри практики
- Преводите се проверяват за точност и културна съобразност
- PR-овете се преглеждат от поддържащи и общността
- Образователната яснота е поставена на първо място
- Примерите с код трябва да следват текущите добри практики
- Преводите се преглеждат за точност и културна уместност
## Система за превод
## Система за преводи
### Автоматичен превод
### Автоматизиран превод
- Използва GitHub Actions с workflow co-op-translator
- Използва GitHub Actions с co-op-translator workflow
- Превежда автоматично на 50+ езика
- Изходни файлове в основните директории
- Преведени файлове в директории `translations/{language-code}/`
- Изходните файлове са в основните директории
- Преведените файлове в `translations/{language-code}/` директории
### Добавяне на ръчни подобрения в преводите
### Добавяне на ръчни подобрения в превода
1. Намирайте файл в `translations/{language-code}/`
2. Правете подобрения, като запазвате структурата
3. Уверете се, че кодовите примери остават функционални
4. Тествайте всяко локализирано куиз съдържание
1. Намерете файла в `translations/{language-code}/`
2. Направете подобрения, като запазвате структурата
3. Уверете се, че примерите с код остават функционални
4. Тествайте всяко локализирано съдържание за тестове
### Метаданни за превод
### Метаданни за превода
Преведените файлове съдържат метаданни в заглавен блок:
Преведените файлове включват хедър с метаданни:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -289,120 +287,120 @@ CO_OP_TRANSLATOR_METADATA:
-->
```
## Отстраняване на грешки и проблеми
## Отстраняване на грешки и решаване на проблеми
### Чести проблеми
**Quiz app не стартира**:
**Quiz app fails to start**:
- Проверете версията на Node.js (препоръчително v14+)
- Изтрийте `node_modules` и `package-lock.json`, след това стартирайте `npm install` пак
- Изтрийте `node_modules` и `package-lock.json`, стартирайте `npm install` отново
- Проверете за конфликти на портове (по подразбиране: Vite използва порт 5173)
**API сървърът не стартира**:
- Уверете се, че версията на Node.js е минимум node >=10
- Проверете дали портът не е зает
**API server won't start**:
- Уверете се, че версията на Node.js отговаря на минималната (node >=10)
- Проверете дали портът вече не е зает
- Уверете се, че всички зависимости са инсталирани с `npm install`
**Browser extension не се зарежда**:
**Browser extension won't load**:
- Проверете дали manifest.json е правилно форматиран
- Проверете браузърния конзолен лог за грешки
- Следвайте инструкции за инсталиране според браузъра
- Проверете конзолата на браузъра за грешки
- Следвайте инструкции за инсталиране на разширения, специфични за браузъра
**Проблеми с Python chat проекта**:
**Python chat project issues**:
- Уверете се, че пакетът OpenAI е инсталиран: `pip install openai`
- Проверете дали променливата на средата GITHUB_TOKEN е зададена
- Проверете, че променливата на средата GITHUB_TOKEN е зададена
- Проверете разрешенията за достъп до GitHub Models
**Docsify не обслужва документация**:
**Docsify not serving docs**:
- Инсталирайте 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+ езика) прави пълните клонинги големи
- Използвайте плитък клон ако работите само с съдържание: `git clone --depth 1`
- Изключвайте преводите от търсене при работа с английско съдържание
- Процесите на билд може да са бавни при първоначално изпълнение (npm install, Vite build)
- Голям брой преведени файлове (50+ езика) прави пълните клонове големи
- Използвайте shallow clone, ако работите само с съдържание: `git clone --depth 1`
- Изключете преводите от търсенията, когато работите с английско съдържание
- Процесите за билд може да са бавни при първото изпълнение (npm install, Vite build)
## Съображения за сигурността
## Съображения за сигурност
### Променливи на средата
- Никога не комитвайте API ключове в репозитория
- API ключовете никога не трябва да се комитират в репозитория
- Използвайте `.env` файлове (вече в `.gitignore`)
- Описвайте нужните променливи на средата в README файловете на проектите
- Документирайте необходимите променливи на средата в README файловете на проектите
### Python проекти
- Използвайте виртуални среди: `python -m venv venv`
- Поддържайте зависимостите актуални
- GitHub токените трябва да имат минимално необходими права
- GitHub токените трябва да имат минимално необходими разрешения
### Достъп до GitHub Models
- Необходими са Personal Access Tokens (PAT) за GitHub Models
- Лични токени за достъп (PAT) са необходими за GitHub Models
- Токените трябва да се съхраняват като променливи на средата
- Никога не комитвайте токени или креденшъли
- Никога не комитвайте токени или идентификационни данни
## Допълнителни бележки
### Целева аудитория
- Напълно начинаещи в уеб разработката
- Студенти и самоучачи
- Учители, ползващи учебната програма в класни стаи
- Студенти и самообучаващи се
- Учители, използващи учебната програма в класни стаи
- Съдържанието е проектирано за достъпност и постепенно изграждане на умения
### Образователна философия
- Обучение, базирано на проекти
- Чести проверки на знанията (куизове)
- Подход, базиран на проекти
- Чести проверки на знанията (тестове)
- Практически упражнения с код
- Примери за реално приложение
- Фокус върху основите преди рамки
- Примери с реални приложения
- Фокус върху основите преди фреймуърковете
### Поддръжка на репозитория
- Активна общност от учащи и допринасящи
- Редовни ъпдейти на зависимости и съдържание
- Проследяване на проблеми и обсъждания от поддръжниците
- Атоматизирани обновления на преводите чрез GitHub Actions
- Редовни актуализации на зависимости и съдържание
- Проблемите и дискусиите се следят от поддържащите
- Актуализациите на преводите автоматизирани чрез 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) препоръчан за учащите
- Допълнителни курсове: Generative AI, Data Science, ML, IoT учебни планове налични
- [Модули на 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) препоръчва се за учащите
- Допълнителни курсове: Generative 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 quiz application
- `7-bank-project/README.md` - Banking application with authentication
- `5-browser-extension/README.md` - Browser extension development
- `6-space-game/README.md` - Canvas-based game development
- `9-chat-project/README.md` - AI chat assistant project
### Структура на монорепозитория
### Структура на монорепо
Въпреки че не е традиционен монорепозиториум, този репозиторий съдържа множество независими проекти:
Въпреки че не е традиционно монорепо, този репозиториум съдържа множество независими проекти:
- Всеки урок е самостоятелен
- Проектите не споделят зависимости
- Работете по отделните проекти, без да засягате останалите
- Клонирайте целия репозиторий за пълноценно обучение с цялата учебна програма
- Работете по отделни проекти, без да засягате другите
- Клонирайте целия репозиториум за пълното преживяване на учебната програма
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Отказ от отговорност**:
Този документ е преведен с помощта на AI преводаческа услуга [Co-op Translator](https://github.com/Azure/co-op-translator). Въпреки че се стремим към точност, моля, имайте предвид, че автоматизираните преводи могат да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Не носим отговорност за недоразумения или неправилни тълкувания, възникнали от използването на този превод.
Този документ е преведен с помощта на AI преводаческа услуга [Co-op Translator](https://github.com/Azure/co-op-translator). Въпреки че се стремим към точност, имайте предвид, че автоматизираните преводи могат да съдържат грешки или неточности. Оригиналният документ на оригиналния език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Не носим отговорност за каквито и да е недоразумения или погрешни тълкувания, възникнали в резултат на използването на този превод.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -1,7 +1,7 @@
{
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8",
"translation_date": "2026-03-06T13:21:56+00:00",
"original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-27T20:12:04+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "ro"
},
@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T13:32:45+00:00",
"translation_date": "2026-03-27T20:31:44+00:00",
"source_file": "AGENTS.md",
"language_code": "ro"
},

@ -1,30 +1,30 @@
# AGENTS.md
## Prezentarea Proiectului
## Prezentare generală a proiectului
Acesta este un depozit curricular educațional pentru predarea fundamentelor dezvoltării web începătorilor. Curriculumul este un curs cuprinzător de 12 săptămâni dezvoltat de Microsoft Cloud Advocates, cuprinzând 24 de lecții practice care acoperă JavaScript, CSS și HTML.
Aceasta este o arhivă curriculară educațională pentru predarea elementelor fundamentale de dezvoltare web pentru începători. Curriculumul este un curs cuprinzător de 12 săptămâni dezvoltate de Microsoft Cloud Advocates, care include 24 de lecții practice acoperind JavaScript, CSS și HTML.
### Componente Cheie
### Componente cheie
- **Conținut educațional**: 24 de lecții structurate organizate în module bazate pe proiecte
- **Proiecte practice**: Terrarium, Joc de tastare, Extensie de browser, Joc spațial, Aplicație bancară, Editor de cod și Asistent AI chat
- **Proiecte practice**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor și AI Chat Assistant
- **Chestionare interactive**: 48 de chestionare cu câte 3 întrebări fiecare (evaluări pre/post-lecție)
- **Suport multilingv**: Traduceri automate pentru peste 50 de limbi prin GitHub Actions
- **Tehnologii**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (pentru proiecte AI)
- **Suport multi-limbă**: Traduceri automate pentru 50+ de limbi prin GitHub Actions
- **Tehnologii**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (pentru proiectele AI)
### Arhitectură
- Depozit educațional cu structură pe bază de lecții
- Arhivă educațională cu structură bazată pe lecții
- Fiecare dosar de lecție conține README, exemple de cod și soluții
- Proiecte autonome în directoare separate (quiz-app, diverse proiecte de lecție)
- Proiecte independente în directoare separate (quiz-app, diverse proiecte de lecții)
- Sistem de traducere folosind GitHub Actions (co-op-translator)
- Documentație servită prin Docsify și disponibilă ca PDF
## Comenzi de Configurare
## Comenzi de configurare
Acest depozit este destinat în principal consumului de conținut educațional. Pentru lucru cu proiecte specifice:
Această arhivă este destinată în principal consumului de conținut educațional. Pentru a lucra cu proiecte specifice:
### Configurare principală a depozitului
### Configurare principală a repository-ului
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
@ -41,7 +41,7 @@ npm run build # Construiește pentru producție
npm run lint # Rulează ESLint
```
### API Proiect Bancar (Node.js + Express)
### API pentru proiectul Bank (Node.js + Express)
```bash
cd 7-bank-project/api
@ -51,7 +51,7 @@ npm run lint # Rulează ESLint
npm run format # Formatează cu Prettier
```
### Proiecte Extensie Browser
### Proiecte Browser Extension
```bash
cd 5-browser-extension/solution
@ -59,7 +59,7 @@ npm install
# Urmați instrucțiunile specifice browserului pentru încărcarea extensiilor
```
### Proiecte Joc Spațial
### Proiecte Space Game
```bash
cd 6-space-game/solution
@ -67,7 +67,7 @@ npm install
# Deschide index.html în browser sau folosește Live Server
```
### Proiect Chat (Backend Python)
### Proiect Chat (backend Python)
```bash
cd 9-chat-project/solution/backend/python
@ -76,207 +76,207 @@ pip install openai
python api.py
```
## Flux de Dezvoltare
## Flux de dezvoltare
### Pentru Contribuitori de Conținut
### Pentru contribuitorii de conținut
1. **Fork la depozit** în contul tău GitHub
1. **Fork la repository** în contul tău GitHub
2. **Clonează fork-ul** local
3. **Creează un branch nou** pentru modificările tale
3. **Creează un nou branch** pentru modificările tale
4. Fă modificări în conținutul lecțiilor sau în exemplele de cod
5. Testează orice modificări de cod în directoarele proiectelor relevante
6. Trimite pull request-uri urmând ghidurile de contribuție
5. Testează orice modificare de cod în directoarele proiectelor relevante
6. Trimite pull requests urmând ghidurile de contribuție
### Pentru Învățăcei
### Pentru cursanți
1. Fă fork sau clonează depozitul
1. Fork sau clonează repository-ul
2. Navighează secvențial prin directoarele lecțiilor
3. Citește fișierele README pentru fiecare lecție
4. Completează chestionarele pre-lecție la https://ff-quizzes.netlify.app/web/
5. Parcurge exemplele de cod din dosarele lecțiilor
6. Realizează temele și provocările
7. Completează chestionarele post-lecție
5. Parcurge exemplele de cod din folderele lecțiilor
6. Finalizează temele și provocările
7. Susține chestionarele post-lecție
### Dezvoltare Live
### Dezvoltare locală (Live Development)
- **Documentație**: Rulează `docsify serve` la rădăcină (port 3000)
- **Documentație**: Rulează `docsify serve` în rădăcină (portul 3000)
- **Quiz App**: Rulează `npm run dev` în directorul quiz-app
- **Proiecte**: Folosește extensia VS Code Live Server pentru proiectele HTML
- **Proiecte API**: Rulează `npm start` în directoarele API respective
## Instrucțiuni de Testare
## Instrucțiuni de testare
### Testarea Quiz App
### Testare Quiz App
```bash
cd quiz-app
npm run lint # Verifică problemele legate de stilul codului
npm run build # Verifică dacă build-ul reușește
npm run lint # Verifică probleme de stil ale codului
npm run build # Verifică dacă compilarea reușește
```
### Testarea API Bancar
### Testare Bank API
```bash
cd 7-bank-project/api
npm run lint # Verifica problemele de stil ale codului
npm run lint # Verifică problemele de stil din cod
node server.js # Verifică dacă serverul pornește fără erori
```
### Abordare Generală de Testare
### Abordare generală de testare
- Acesta este un depozit educațional fără teste automate complete
- Aceasta este o arhivă educațională fără teste automate cuprinzătoare
- Testarea manuală se concentrează pe:
- Executarea corectă a exemplelor de cod fără erori
- Funcționarea corectă a linkurilor în documentație
- Finalizarea cu succes a construziunilor proiectelor
- Urmarea celor mai bune practici în exemple
- Exemplele de cod rulează fără erori
- Linkurile din documentație funcționează corect
- Build-urile proiectelor se finalizează cu succes
- Exemplele urmează bune practici
### Verificări înainte de Trimitere
### Verificări pre-trimitere
- Rulează `npm run lint` în directoarele cu package.json
- Verifică validitatea linkurilor markdown
- Verifică dacă linkurile markdown sunt valide
- Testează exemplele de cod în browser sau Node.js
- Verifică că traducerile păstrează structura corectă
- Verifică că traducerile păstrează structura corespunzătoare
## Ghid de Stil pentru Cod
## Ghid de stil pentru cod
### JavaScript
- Folosește sintaxa modernă ES6+
- Respectă configurațiile standard ESLint oferite în proiecte
- Folosește nume semnificative de variabile și funcții pentru claritate educațională
- Adaugă comentarii care explică conceptele pentru învățăcei
- Formatează cu Prettier unde este configurat
- Urmează configurațiile standard ESLint furnizate în proiecte
- Folosește nume semnificative pentru variabile și funcții pentru claritate educațională
- Adaugă comentarii care explică conceptele pentru cursanți
- Formatează folosind Prettier acolo unde este configurat
### HTML/CSS
- Elemente semantice HTML5
- Principii de design responsive
- Convenții clare de denumire a claselor
- Comentarii care explică tehnicile CSS pentru învățăcei
- Comentarii care explică tehnicile CSS pentru cursanți
### Python
- Respectă ghidurile stil PEP 8
- Exemple clare și educaționale de cod
- Hinturi de tipuri acolo unde sunt utile pentru învățare
- Ghiduri de stil PEP 8
- Exemple de cod clare și educaționale
- Hint-uri de tipare acolo unde sunt utile pentru învățare
### Documentație Markdown
- Ierarhie clară a titlurilor
- Blocuri de cod cu specificarea limbajului
- Blocuri de cod cu specificație a limbajului
- Linkuri către resurse suplimentare
- Capturi de ecran și imagini în directoarele `images/`
- Text alternativ pentru imagini pentru accesibilitate
### Organizarea Fișierelor
### Organizarea fișierelor
- Lecțiile numerotate secvențial (1-getting-started-lessons, 2-js-basics, etc.)
- Fiecare proiect are directoare `solution/` și adesea `start/` sau `your-work/`
- Imaginile stocate în foldere specifice lecțiilor, `images/`
- Traduceri în structura `translations/{language-code}/`
- Fiecare proiect are `solution/` și adesea `start/` sau `your-work/` directoare
- Imaginile stocate în foldere `images/` specifice lecțiilor
- Traducerile în structura `translations/{language-code}/`
## Construire și Desfășurare
## Build și Deployment
### Desfășurarea Quiz App (Azure Static Web Apps)
### Deployment Quiz App (Azure Static Web Apps)
quiz-app este configurat pentru desfășurare în Azure Static Web Apps:
Quiz-app este configurat pentru deployment pe Azure Static Web Apps:
```bash
cd quiz-app
npm run build # Creează folderul dist/
# Desfășoară prin fluxul de lucru GitHub Actions la push către main
# Desfășoară prin fluxul de lucru GitHub Actions la împingerea în ramura main
```
Configurare Azure Static Web Apps:
- **Locația aplicației**: `/quiz-app`
- **Locația outputului**: `dist`
Azure Static Web Apps configuration:
- **App location**: `/quiz-app`
- **Output location**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Generare PDF Documentație
### Generare PDF pentru documentație
```bash
npm install # Instalează docsify-to-pdf
npm run convert # Generează PDF din docs
npm run convert # Generează PDF din documentație
```
### Documentație Docsify
```bash
npm install -g docsify-cli # Instalează Docsify global
npm install -g docsify-cli # Instalează Docsify la nivel global
docsify serve # Servește pe localhost:3000
```
### Construiri specifice proiectului
### Build-uri specifice proiectelor
Fiecare director de proiect poate avea propriul proces de construire:
- Proiecte Vue: `npm run build` creează bundle-uri de producție
- Proiecte statice: fără pas de construire, fișiere servite direct
Fiecare director de proiect poate avea propriul proces de build:
- Proiecte Vue: `npm run build` creează bundle-uri pentru producție
- Proiecte statice: Fără pas de build, servește fișierele direct
## Ghid pentru Pull Requests
## Ghid pentru Pull Request-uri
### Formatul Titlului
### Formatul titlului
Folosește titluri clare, descriptive care indică aria modificării:
- `[Quiz-app] Adaugă chestionar nou pentru lecția X`
- `[Lesson-3] Corectează greșeală în proiectul terrarium`
- `[Translation] Adaugă traducerea în spaniolă pentru lecția 5`
- `[Docs] Actualizează instrucțiunile de configurare`
Folosește titluri clare și descriptive care indică aria modificării:
- `[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`
### Verificări Necesare
### Verificări necesare
Înainte de a trimite un PR:
1. **Calitate cod**:
- Rulează `npm run lint` în directoarele proiectelor afectate
- Rezolvă toate erorile și avertismentele lint
1. **Calitatea codului**:
- Rulează `npm run lint` în directoarele proiectului afectate
- Remediază toate erorile și avertismentele de lint
2. **Verificare construire**:
- Rulează `npm run build` dacă este cazul
- Asigură-te că nu apar erori la construire
2. **Verificare build**:
- Rulează `npm run build` dacă este aplicabil
- Asigură-te că nu există erori de build
3. **Validare linkuri**:
- Testează toate linkurile markdown
- Verifică referințele imaginii funcționează
- Verifică referințele la imagini
4. **Revizuire conținut**:
- Corectează ortografia și gramatica
- Asigură integritatea și claritatea educațională a exemplelor
- Verifică ortografia și gramatica
- Asigură-te că exemplele de cod sunt corecte și educaționale
- Verifică că traducerile păstrează sensul original
### Cerințe de Contribuție
### Cerințe pentru contribuție
- Acceptă Microsoft CLA (verificare automată la primul PR)
- Respectă [Codul de Conduită Open Source Microsoft](https://opensource.microsoft.com/codeofconduct/)
- Consultă [CONTRIBUTING.md](./CONTRIBUTING.md) pentru ghiduri detaliate
- Referințează numere de issue în descrierea PR-ului dacă este cazul
- Urmează [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Vezi [CONTRIBUTING.md](./CONTRIBUTING.md) pentru ghiduri detaliate
- Referă numerele issue-urilor în descrierea PR-ului dacă este cazul
### Procesul de Revizuire
### Procesul de revizuire
- PR-urile sunt revizuite de mentori și comunitate
- Se prioritizează claritatea educațională
- Exemplele de cod trebuie să urmeze cele mai bune practici actuale
- PR-urile sunt revizuite de maintaineri și comunitate
- Claritatea educațională este prioritară
- Exemplele de cod trebuie să urmeze bune practici actuale
- Traducerile sunt revizuite pentru acuratețe și adecvare culturală
## Sistemul de Traducere
## Sistemul de traducere
### Traducere Automată
### Traducere automată
- Folosește GitHub Actions cu workflow-ul co-op-translator
- Traduce automat în peste 50 de limbi
- Traduce automat în 50+ de limbi
- Fișiere sursă în directoarele principale
- Fișiere traduse în structura `translations/{language-code}/`
- Fișiere traduse în directoarele `translations/{language-code}/`
### Adăugarea Îmbunătățirilor Manuale la Traducere
### Adăugarea îmbunătățirilor manuale la traduceri
1. Localizează fișierul în `translations/{language-code}/`
2. Fă îmbunătățiri păstrând structura
3. Asigură-te că exemplele de cod rămân funcționale
4. Testează orice conținut localizat de chestionar
4. Testează orice conținut localizat al chestionarelor
### Metadate Traducere
### Metadate pentru traduceri
Fișierele traduse includ antet cu metadate:
Fișierele traduse includ antetul de metadate:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -289,120 +289,120 @@ CO_OP_TRANSLATOR_METADATA:
-->
```
## Depanare și Rezolvare Probleme
## Depanare și rezolvarea problemelor
### Probleme Comune
### Probleme comune
**Quiz app nu pornește**:
- Verifică versiunea Node.js (recomandat v14+)
- Șterge `node_modules` și `package-lock.json`, rulează din nou `npm install`
- Verifică conflicte de port (implicit: Vite folosește port 5173)
- Șterge `node_modules` și `package-lock.json`, rulează `npm install` din nou
- Verifică conflictele de port (implicit: Vite folosește portul 5173)
**Server API nu pornește**:
- Asigură versiunea minimă Node.js (node >=10)
**Serverul API nu pornește**:
- Verifică dacă versiunea Node.js îndeplinește minimul (node >=10)
- Verifică dacă portul este deja folosit
- Asigură instalarea dependențelor cu `npm install`
- Asigură-te că toate dependențele sunt instalate cu `npm install`
**Extensia browser nu se încarcă**:
- Verifică formatul corect al manifest.json
- Verifică consola browser pentru erori
- Urmează instrucțiunile specifice browser-ului pentru instalare extensie
**Browser extension nu se încarcă**:
- Verifică dacă manifest.json este formatat corect
- Verifică consola browser-ului pentru erori
- Urmează instrucțiunile specifice browser-ului pentru instalarea extensiei
**Probleme proiect chat Python**:
- Asigură pachetul OpenAI instalat: `pip install openai`
- Verifică variabila de mediu GITHUB_TOKEN este setată
- Asigură-te că pachetul OpenAI este instalat: `pip install openai`
- Verifică variabila de mediu GITHUB_TOKEN este setată
- Verifică permisiunile de acces GitHub Models
**Docsify nu servește documentația**:
- Instalează docsify-cli global: `npm install -g docsify-cli`
- Rulează din directorul rădăcină al depozitului
- Verifică existența fișierului `docs/_sidebar.md`
- Rulează din directorul rădăcină al repository-ului
- Verifică `docs/_sidebar.md` există
### Sfaturi pentru Mediu de Dezvoltare
### Sfaturi pentru mediul de dezvoltare
- Folosește VS Code cu extensia Live Server pentru proiectele HTML
- Instalează extensiile ESLint și Prettier pentru formatare constantă
- Folosește DevTools din browser pentru depanare JavaScript
- Pentru proiecte Vue, instalează extensia Vue DevTools pentru browser
- Instalează extensiile ESLint și Prettier pentru format consistent
- Folosește DevTools din browser pentru depanarea JavaScript
- Pentru proiectele Vue, instalează extensia Vue DevTools pentru browser
### Considerații de Performanță
### Considerații de performanță
- Numărul mare de fișiere traduse (peste 50 de limbi) înseamnă că clonările complete sunt mari
- Folosește shallow clone dacă lucrezi doar pe conținut: `git clone --depth 1`
- Exclude traducerile din căutări când lucrezi pe conținut în engleză
- Procesele de construire pot fi lente la prima execuție (npm install, construcție Vite)
- Numărul mare de fișiere traduse (50+ de limbi) înseamnă că clone-urile complete sunt mari
- Folosește clone superficial dacă lucrezi doar pe conținut: `git clone --depth 1`
- Exclude traducerile din căutări când lucrezi pe conținutul în engleză
- Procesele de build pot fi lente la prima rulare (npm install, Vite build)
## Considerații de Securitate
## Considerații de securitate
### Variabile de Mediu
### Variabile de mediu
- Cheile API nu trebuie niciodată comise în depozit
- Folosește fișiere `.env` (deja incluse în `.gitignore`)
- Cheile API nu trebuie niciodată comise în repository
- Folosește fișiere `.env` (sunt deja în `.gitignore`)
- Documentează variabilele de mediu necesare în README-urile proiectelor
### Proiecte Python
- Folosește medii virtuale: `python -m venv venv`
- Menține dependențele actualizate
- Tokenii GitHub trebuie să aibă permisiuni minime necesare
- Păstrează dependențele actualizate
- Token-urile GitHub ar trebui să aibă permisiunile minime necesare
### Acces GitHub Models
- Se cer Tokenuri Personale de Acces (PAT) pentru GitHub Models
- Tokenii trebuie stocați ca variabile de mediu
- Nu comite niciodată tokenuri sau credențiale
- Personal Access Tokens (PAT) necesare pentru GitHub Models
- Token-urile ar trebui stocate ca variabile de mediu
- Nu comite niciodată token-uri sau credențiale
## Note Suplimentare
## Note suplimentare
### Public Țintă
### Public țintă
- Începători compleți în dezvoltare web
- Începători compleți în dezvoltarea web
- Studenți și autodidacți
- Profesori care folosesc curriculumul în săli de clasă
- Conținut conceput pentru accesibilitate și dezvoltare graduală a abilităților
- Profesori care folosesc curriculumul în sălile de clasă
- Conținutul este conceput pentru accesibilitate și construire treptată a abilităților
### Filosofie Educațională
### Filosofia educațională
- Abordare bazată pe învățarea prin proiecte
- Abordare de învățare bazată pe proiecte
- Verificări frecvente ale cunoștințelor (chestionare)
- Exerciții practice de programare
- Exemple de aplicare în lumea reală
- Accent pe fundamente înainte de framework-uri
- Exerciții practice de codare
- Exemple de aplicații din lumea reală
- Accent pe elementele fundamentale înaintea framework-urilor
### Mentenanța Depozitului
### Mentenanța repository-ului
- Comunitate activă de învățăcei și contribuitori
- Actualizări regulate la dependențe și conținut
- Probleme și discuții monitorizate de mentori
- Actualizări traduceri automate prin GitHub Actions
- Comunitate activă de cursanți și contributori
- Actualizări regulate ale dependențelor și conținutului
- Issue-uri și discuții monitorizate de maintaineri
- Actualizările de traducere automatizate prin GitHub Actions
### Resurse Relatate
### Resurse conexe
- [Module Microsoft Learn](https://docs.microsoft.com/learn/)
- [Resurse Student Hub](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) recomandat pentru învățăcei
- Cursuri suplimentare: AI Generativ, Data Science, ML, curricula IoT disponibile
- [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) recomandat pentru cursanți
- Cursuri adiționale: Generative AI, Data Science, ML, IoT curricula disponibile
### Lucrul cu Proiecte Specifice
### Lucrul cu proiecte specifice
Pentru instrucțiuni detaliate despre proiecte individuale, consultă fișierele README în:
- `quiz-app/README.md` - aplicație quiz Vue 3
- `7-bank-project/README.md` - aplicație bancară cu autentificare
- `5-browser-extension/README.md` - dezvoltare extensie browser
- `6-space-game/README.md` - dezvoltare joc pe canvas
- `9-chat-project/README.md` - proiect asistent AI chat
Pentru instrucțiuni detaliate despre proiectele individuale, consultă fișierele README din:
- `quiz-app/README.md` - Vue 3 quiz application
- `7-bank-project/README.md` - Banking application with authentication
- `5-browser-extension/README.md` - Browser extension development
- `6-space-game/README.md` - Canvas-based game development
- `9-chat-project/README.md` - AI chat assistant project
### Structura Monorepo
### Structura monorepo-ului
Deși nu este un monorepo tradițional, acest depozit conține mai multe proiecte independente:
Deși nu este un monorepo tradițional, acest repository conține multiple proiecte independente:
- Fiecare lecție este autonomă
- Proiectele nu împart dependențe
- Lucrează pe proiecte individuale fără a afecta altele
- Clonează întregul depozit pentru experiența completă a curriculumului
- Lucrează la proiecte individuale fără a afecta altele
- Clonează întregul repo pentru experiența completă a curriculumului
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Declinare de responsabilitate**:
Acest document a fost tradus folosind serviciul de traducere automată [Co-op Translator](https://github.com/Azure/co-op-translator). Deși ne străduim pentru acuratețe, vă rugăm să rețineți că traducerile automate pot conține erori sau inexactități. Documentul original în limba sa nativă trebuie considerat sursa autorizată. Pentru informații critice, se recomandă traducerea profesională realizată de un specialist uman. Nu ne asumăm responsabilitatea pentru eventuale neînțelegeri sau interpretări greșite rezultate din utilizarea acestei traduceri.
Acest document a fost tradus folosind serviciul de traducere AI [Co-op Translator](https://github.com/Azure/co-op-translator). Deși ne străduim pentru acuratețe, vă rugăm să rețineți că traducerile automate pot conține erori sau inexactități. Documentul original în limba sa nativă trebuie considerat sursa autorizată. Pentru informații critice, se recomandă o traducere profesională realizată de un traducător uman. Nu ne asumăm nicio răspundere pentru orice neînțelegeri sau interpretări greșite care rezultă din utilizarea acestei traduceri.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->

@ -1,7 +1,7 @@
{
"1-getting-started-lessons/1-intro-to-programming-languages/README.md": {
"original_hash": "bec5e35642176d9e483552bfc82996d8",
"translation_date": "2026-03-06T13:15:58+00:00",
"original_hash": "d5eeb6e975b5864d8da52d4a41941f8d",
"translation_date": "2026-03-27T20:02:09+00:00",
"source_file": "1-getting-started-lessons/1-intro-to-programming-languages/README.md",
"language_code": "sk"
},
@ -493,7 +493,7 @@
},
"AGENTS.md": {
"original_hash": "a362efd06d64d4134a0cfe8515a86d34",
"translation_date": "2026-03-06T13:31:42+00:00",
"translation_date": "2026-03-27T20:29:25+00:00",
"source_file": "AGENTS.md",
"language_code": "sk"
},

@ -2,29 +2,29 @@
## Prehľad projektu
Toto je edukačné úložisko kurikula určené na výučbu základov webového vývoja pre začiatočníkov. Kurikulum je komplexný 12-týždňový kurz vyvinutý Microsoft Cloud Advocates, zahŕňajúci 24 praktických lekcií pokrývajúcich JavaScript, CSS a HTML.
Toto je repozitár vzdelávacieho učebného plánu na výučbu základov webového vývoja pre začiatočníkov. Učebný plán je komplexný 12-týždňový kurz vyvinutý Microsoft Cloud Advocates, ktorý obsahuje 24 praktických lekcií pokrývajúcich JavaScript, CSS a HTML.
### Hlavné komponenty
### Kľúčové súčasti
- **Edukačný obsah**: 24 štruktúrovaných lekcií organizovaných do modulov založených na projektoch
- **Praktické projekty**: Terrárium, Hra na písanie, Rozšírenie prehliadača, Vesmírna hra, Banková aplikácia, Kódový editor a AI Chat asistent
- **Interaktívne kvízy**: 48 kvízov so 3 otázkami každý (pred a po lekcii)
- **Viacjazyčná podpora**: Automatické preklady do 50+ jazykov pomocou GitHub Actions
- **Technológie**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (pre AI projekty)
- **Educational Content**: 24 štruktúrovaných lekcií organizovaných do modulov založených na projektoch
- **Practical Projects**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, and AI Chat Assistant
- **Interactive Quizzes**: 48 kvízov po 3 otázky (hodnotenia pred/po lekcii)
- **Multi-language Support**: Automatické preklady do 50+ jazykov cez GitHub Actions
- **Technologies**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (pre AI projekty)
### Architektúra
- Edukačné úložisko so štruktúrou založenou na lekciách
- Každá lekcia obsahuje README, ukážky kódu a riešenia
- Samostatné projekty v oddelených adresároch (quiz-app, rôzne lekčné projekty)
- Prekladový systém využívajúci GitHub Actions (co-op-translator)
- Dokumentácia poskytovaná cez Docsify a dostupná aj vo formáte PDF
- Vzdelávací repozitár so štruktúrou založenou na lekciách
- Každá zložka lekcie obsahuje README, príklady kódu a riešenia
- Samostatné projekty v oddelených adresároch (quiz-app, rôzne projekty lekcií)
- Systém prekladov využívajúci GitHub Actions (co-op-translator)
- Dokumentácia servírovaná cez Docsify a dostupná ako PDF
## Príkazy na nastavenie
Toto úložisko je primárne určené na štúdium edukačného obsahu. Pre prácu so špecifickými projektmi:
Tento repozitár je primárne určený na konzumáciu vzdelávacieho obsahu. Pre prácu s konkrétnymi projektmi:
### Nastavenie hlavného úložiska
### Hlavné nastavenie repozitára
```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git
@ -37,18 +37,18 @@ cd Web-Dev-For-Beginners
cd quiz-app
npm install
npm run dev # Spustiť vývojový server
npm run build # Vytvoriť produkčnú verziu
npm run build # Zostaviť pre produkciu
npm run lint # Spustiť ESLint
```
### Bankový projekt API (Node.js + Express)
### API bankového projektu (Node.js + Express)
```bash
cd 7-bank-project/api
npm install
npm start # Spustiť API server
npm run lint # Spustiť ESLint
npm run format # Naformátovať pomocou Prettier
npm run format # Naformátovať pomocou Prettieru
```
### Projekty rozšírení prehliadača
@ -56,7 +56,7 @@ npm run format # Naformátovať pomocou Prettier
```bash
cd 5-browser-extension/solution
npm install
# Postupujte podľa pokynov na načítanie rozšírení špecifických pre prehliadač
# Postupujte podľa pokynov na načítanie rozšírenia, ktoré sú špecifické pre prehliadač
```
### Projekty vesmírnej hry
@ -76,42 +76,42 @@ pip install openai
python api.py
```
## Vývojový pracovný tok
## Vývojový pracovný postup
### Pre prispievateľov obsahu
1. **Vytvorte fork úložiska** na svoj GitHub účet
2. **Naklonujte svoj fork** lokálne
1. **Vytvorte fork repozitára** do svojho GitHub účtu
2. **Klonujte svoj fork** lokálne
3. **Vytvorte novú vetvu** pre svoje zmeny
4. Upraviť obsah lekcií alebo ukážky kódu
5. Otestujte zmeny kódu v relevantných projektových adresároch
6. Odoslať pull requesty podľa pravidiel prispievania
4. Upravte obsah lekcie alebo príklady kódu
5. Otestujte zmeny kódu v príslušných adresároch projektov
6. Odošlite pull requesty podľa pokynov na prispievanie
### Pre študentov
1. Forknite alebo klonujte úložisko
2. Postupujte sekvenčne adresáre s lekciami
3. Čítajte README súbory ku každej lekcii
4. Vykonajte predlekcné kvízy na https://ff-quizzes.netlify.app/web/
5. Prejdite si kódové ukážky vo vnútri lekčných adresárov
6. Splňte zadania a výzvy
7. Vykonajte po lekcii kvízy
1. Vytvorte fork alebo sklonujte repozitár
2. Prejdite do priečinkov lekcií postupne
3. Prečítajte si README súbory pre každú lekciu
4. Vyplňte kvízy pred lekciou na https://ff-quizzes.netlify.app/web/
5. Prejdite si príklady kódu v priečinkoch lekcií
6. Dokončite úlohy a výzvy
7. Urobte kvízy po lekcii
### Live vývoj
### Živý vývoj
- **Dokumentácia**: Spustite `docsify serve` v koreňovom adresári (port 3000)
- **Quiz App**: Spustite `npm run dev` v adresári quiz-app
- **Projekty**: Použite VS Code rozšírenie Live Server pre HTML projekty
- **Projekty**: Použite rozšírenie VS Code Live Server pre HTML projekty
- **API projekty**: Spustite `npm start` v príslušných adresároch API
## Inštrukcie na testovanie
## Pokyny na testovanie
### Testovanie Quiz App
```bash
cd quiz-app
npm run lint # Skontrolujte problémy so štýlom kódu
npm run build # Overte úspešnosť zostavenia
npm run lint # Skontrolujte chyby v štýle kódu
npm run build # Overte, že zostavenie bude úspešné
```
### Testovanie Bank API
@ -119,164 +119,164 @@ npm run build # Overte úspešnosť zostavenia
```bash
cd 7-bank-project/api
npm run lint # Skontrolujte problémy so štýlom kódu
node server.js # Overte, či sa server spustí bez chýb
node server.js # Overte, že server sa spustí bez chýb
```
### Všeobecný testovací postup
### Všeobecný prístup k testovaniu
- Ide o edukačné úložisko bez komplexných automatizovaných testov
- Toto je vzdelávací repozitár bez komplexných automatizovaných testov
- Manuálne testovanie sa zameriava na:
- Kódové ukážky sa spúšťajú bez chybných hlásení
- Príklady kódu sa spúšťajú bez chýb
- Odkazy v dokumentácii fungujú správne
- Projekty sa úspešne zostavujú
- Ukážky dodržiavajú osvedčené postupy
- Buildy projektov sa úspešne dokončia
- Príklady dodržiavajú osvedčené postupy
### Kontroly pred odoslaním
- Spustite `npm run lint` v adresároch, kde je package.json
- Spustite `npm run lint` v adresároch s package.json
- Overte, že markdown odkazy sú platné
- Otestujte ukážky kódu v prehliadači alebo Node.js
- Skontrolujte, či preklady zachovávajú správnu štruktúru
- Otestujte príklady kódu v prehliadači alebo Node.js
- Skontrolujte, že preklady zachovávajú správnu štruktúru
## Pravidlá štýlu kódu
## Pokyny k štýlu kódu
### JavaScript
- Používajte moderný ES6+ syntax
- Dodržiavajte štandardné ESLint konfigurácie definované v projektoch
- Používajte zrozumiteľné názvy premenných a funkcií pre lepšie pochopenie
- Používajte modernú syntax ES6+
- Dodržiavajte štandardné konfigurácie ESLint poskytované v projektoch
- Používajte zmysluplné názvy premenných a funkcií pre vzdelávaciu zrozumiteľnosť
- Pridávajte komentáre vysvetľujúce koncepty pre študentov
- Formátujte kód pomocou Prettier tam, kde je nastave
- Formátujte pomocou Prettier tam, kde je nakonfigurova
### HTML/CSS
- Používajte sémantické HTML5 prvky
- Dodržiavajte princípy responzívneho dizajnu
- Jasné pomenovanie CSS tried
- Sémantické elementy HTML5
- Zásady responzívneho dizajnu
- Jasné konvencie pomenovania tried
- Komentáre vysvetľujúce CSS techniky pre študentov
### Python
- Dodržiavajte štandard PEP 8
- Jasné, edukačné ukážky kódu
- Používajte typové anotácie tam, kde sú užitočné pre učenie
- Štýlové pokyny PEP 8
- Jasné, vzdelávacie príklady kódu
- Označovanie typov tam, kde pomáha pri učení
### Markdown dokumentácia
### Dokumentácia v Markdown
- Jasná hierarchia nadpisov
- Bloky kódu so špecifikáciou jazyka
- Odkazy na ďalšie zdroje
- Screenshoty a obrázky v adresároch `images/`
- Alt text pre obrázky pre zlepšenie prístupnosti
- Snímky obrazovky a obrázky v adresároch `images/`
- Alternatívny text pre obrázky z dôvodu prístupnosti
### Organizácia súborov
- Lekcie číslované postupne (1-getting-started-lessons, 2-js-basics atď.)
- Každý projekt má adresáre `solution/` a často aj `start/` alebo `your-work/`
- Obrázky uložené v lekciových `images/` zložkách
- Preklady v štruktúre `translations/{jazykový-kód}/`
- Lekcie očíslované postupne (1-getting-started-lessons, 2-js-basics, etc.)
- Každý projekt má adresáre `solution/` a často `start/` alebo `your-work/`
- Obrázky uložené v priečinkoch `images/` pre každú lekciu
- Preklady v štruktúre `translations/{language-code}/`
## Sestavenie a nasadenie
## Build a nasadenie
### Nasadenie Quiz App (Azure Static Web Apps)
Quiz-app je nakonfigurovaná pre nasadenie na Azure Static Web Apps:
Quiz-app je nakonfigurovaný pre nasadenie na Azure Static Web Apps:
```bash
cd quiz-app
npm run build # Vytvára priečinok dist/
# Nasadzuje cez workflow GitHub Actions pri pushi do main
npm run build # Vytvorí priečinok dist/
# Nasadzuje cez workflow GitHub Actions pri pushi do vetvy main
```
Konfigurácia Azure Static Web Apps:
- **Umiestnenie aplikácie**: `/quiz-app`
- **Výstupné umiestnenie**: `dist`
- **App location**: `/quiz-app`
- **Output location**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Generovanie PDF dokumentácie
```bash
npm install # Nainštalujte docsify-to-pdf
npm run convert # Vygenerujte PDF z docs
npm install # Nainštalovať docsify-to-pdf
npm run convert # Vygenerovať PDF z dokumentácie
```
### Dokumentácia cez Docsify
### Dokumentácia Docsify
```bash
npm install -g docsify-cli # Nainštalujte Docsify globálne
docsify serve # Spustiť na localhost:3000
docsify serve # Spustite server na localhost:3000
```
### Špecifické zostavenia projektov
### Špecifické buildy projektov
Každý projektový adresár môže mať vlastný build proces:
- Vue projekty: `npm run build` vytvára produkčné balíky
- Statické projekty: Bez build kroku, súbory servované priamo
Každý adresár projektu môže mať vlastný build proces:
- Vue projekty: `npm run build` vytvorí produkčné balíky
- Statické projekty: Bez kroku build, súbory podávajte priamo
## Pravidlá pre pull requesty
## Pokyny pre Pull Requesty
### Formát nadpisu
### Formát názvu
Používajte jasné, popisné názvy vyjadrujúce oblasť zmeny:
- `[Quiz-app] Pridanie nového kvízu pre lekciu X`
- `[Lesson-3] Oprava preklepu v projekte terrárium`
- `[Translation] Pridanie španielskeho prekladu pre lekciu 5`
- `[Docs] Aktualizácia inštrukcií na nastavenie`
Použite jasné, popisné názvy, ktoré uvádzajú oblasť zmeny:
- `[Quiz-app] Pridať nový kvíz pre lekciu X`
- `[Lesson-3] Opravte preklep v projekte terrarium`
- `[Translation] Pridať španielsky preklad pre lekciu 5`
- `[Docs] Aktualizujte inštrukcie na nastavenie`
### Požadované kontroly
### Povinné kontroly
Pred odoslaním PR:
1. **Kvalita kódu**:
- Spustite `npm run lint` v dotknutých projektových adresároch
- Spustite `npm run lint` v postihnutých adresároch projektov
- Opravte všetky linting chyby a varovania
2. **Overenie buildu**:
- Spustite `npm run build`, ak je to relevantné
- Uistite sa, že nie sú chyby v build procese
- Uistite sa, že nie sú žiadne chyby pri buildovaní
3. **Validácia odkazov**:
3. **Overenie odkazov**:
- Otestujte všetky markdown odkazy
- Overte správne fungovanie odkazov na obrázky
- Overte, že odkaz na obrázky funguje
4. **Kontrola obsahu**:
- Korektúra pravopisu a gramatiky
- Overenie správnosti a edukačnej hodnoty kódových príkladov
- Overenie, že preklady zachovávajú pôvodný význam
- Zabezpečte, aby boli príklady kódu správne a vzdelávacie
- Overte, že preklady zachovávajú pôvodný význam
### Požiadavky na prispievateľov
### Požiadavky na príspevok
- Súhlas s Microsoft CLA (automatická kontrola pri prvom PR)
- Dodržiavať [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Viac info v [CONTRIBUTING.md](./CONTRIBUTING.md)
- Uvádzať čísla issues v popise PR, ak sa to týka
- Súhlas s Microsoft CLA (automatická kontrola pri prvom PR)
- Dodržiavajte [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Pozrite si [CONTRIBUTING.md](./CONTRIBUTING.md) pre podrobné usmernenia
- Uveďte čísla issue v popise PR, ak sú relevantné
### Proces revízie
- PR prehliadajú správcovia a komunita
- Priorita je edukačná zrozumiteľnosť
- Kódové príklady by mali dodržiavať aktuálne osvedčené postupy
- PR sú kontrolované maintainermi a komunitou
- Uprednostňuje sa vzdelávacia zrozumiteľnosť
- Príklady kódu by mali dodržiavať súčasné osvedčené postupy
- Preklady sa kontrolujú z hľadiska presnosti a kultúrnej vhodnosti
## Prekladový systém
## Systém prekladov
### Automatizovaný preklad
- Využíva GitHub Actions so workflow co-op-translator
- Využíva GitHub Actions s workflow co-op-translator
- Automaticky prekladá do 50+ jazykov
- Zdrojové súbory v hlavných adresároch
- Preložené súbory v `translations/{jazykový-kód}/`
- Preložené súbory v adresároch `translations/{language-code}/`
### Pridávanie manuálnych vylepšení prekladu
### Pridávanie manuálnych vylepšení prekladov
1. Nájdite súbor v `translations/{jazykový-kód}/`
2. Vykonajte úpravy pri zachovaní štruktúry
3. Uistite sa, že kódové príklady zostávajú funkčné
4. Otestujte lokalizovaný obsah kvízu
1. Nájdite súbor v `translations/{language-code}/`
2. Urobte úpravy pri zachovaní štruktúry
3. Zabezpečte, aby príklady kódu zostali funkčné
4. Otestujte akýkoľvek lokalizovaný obsah kvízov
### Metadata prekladu
### Metadáta prekladu
Preložené súbory obsahujú hlavičku metadata:
Preložené súbory obsahujú hlavičku s metadátami:
```markdown
<!--
CO_OP_TRANSLATOR_METADATA:
@ -293,52 +293,52 @@ CO_OP_TRANSLATOR_METADATA:
### Bežné problémy
**Quiz app sa nespúšťa**:
- Skontrolujte verziu Node.js (odporúčaná v14+)
- Odstráňte `node_modules` a `package-lock.json`, spustite `npm install` znova
- Skontrolujte konflikt portov (predvolené: Vite používa port 5173)
**Quiz app sa nespustí**:
- Skontrolujte verziu Node.js (odporúčané v14+)
- Vymažte `node_modules` a `package-lock.json`, potom znova spustite `npm install`
- Skontrolujte konflikty portov (predvolené: Vite používa port 5173)
**API server sa nespúšťa**:
- Overte minimálnu požadovanú verziu Node.js (node >=10)
- Skontrolujte, či port nie je už obsade
- Uistite sa, že všetky závislosti sú nainštalované cez `npm install`
**API server sa nespustí**:
- Overte, že verzia Node.js spĺňa minimum (node >=10)
- Skontrolujte, či port už nie je používa
- Uistite sa, že všetky závislosti sú nainštalované pomocou `npm install`
**Rozšírenie prehliadača sa nenačíta**:
- Skontrolujte správne formátovanie manifest.json
- Prezrite konzolu prehliadača kvôli chybám
- Dodržiavajte inštrukcie inštalácie rozšírení pre daný prehliadač
- Overte, či je manifest.json správne naformátovaný
- Skontrolujte konzolu prehliadača pre chyby
- Postupujte podľa pokynov na inštaláciu rozšírenia špecifických pre prehliadač
**Problémy s Python chat projektom**:
- Overte, či je nainštalovaný balík OpenAI: `pip install openai`
- Skontrolujte, či je nastavená premenná prostredia GITHUB_TOKEN
- Overte prístupové práva k GitHub Models
- Uistite sa, že balík OpenAI je nainštalovaný: `pip install openai`
- Overte, že premenná prostredia GITHUB_TOKEN je nastavená
- Skontrolujte oprávnenia prístupu k GitHub Models
**Docsify neservíruje dokumentáciu**:
**Docsify nespúšťa dokumentáciu**:
- Nainštalujte docsify-cli globálne: `npm install -g docsify-cli`
- Spúšťajte z koreňového adresára repo
- Overte, že existuje súbor `docs/_sidebar.md`
- Spustite z koreňového adresára repozitára
- Skontrolujte, či existuje `docs/_sidebar.md`
### Tipy pre vývojové prostredie
- Používajte VS Code s rozšírením Live Server pre HTML projekty
- Inštalujte ESLint a Prettier rozšírenia pre konzistentné formátovanie
- Používajte prehliadačové DevTools na ladenie JavaScriptu
- Pre Vue projekty nainštalujte Vue DevTools rozšírenie prehliadača
- Nainštalujte rozšírenia ESLint a Prettier pre konzistentné formátovanie
- Používajte DevTools prehliadača na ladenie JavaScriptu
- Pre Vue projekty nainštalujte rozšírenie Vue DevTools do prehliadača
### Výkonnostné úvahy
### Výkonové úvahy
- Veľké množstvo prekladaných súborov (50+ jazykov) spôsobuje veľké clone repozitára
- Používajte shallow clone, ak pracujete len s obsahom: `git clone --depth 1`
- Vynechávajte preklady z vyhľadávania pri práci v angličtine
- Sestavovacie procesy môžu byť pomalé pri prvom spustení (npm install, Vite build)
- Veľký počet preložených súborov (50+ jazykov) znamená, že plné klony sú veľké
- Použite shallow clone, ak pracujete iba s obsahom: `git clone --depth 1`
- Vylúčte preklady z vyhľadávania pri práci s anglickým obsahom
- Build procesy môžu byť pri prvom spustení pomalé (npm install, Vite build)
## Bezpečnostné opatrenia
### Premenné prostredia
- API kľúče by nikdy nemali byť commitované do úložiska
- API kľúče by nikdy nemali byť commitnuté do repozitára
- Používajte `.env` súbory (už v `.gitignore`)
- Dokumentujte požadované premenné prostredia v README projektov
- Zdokumentujte požadované premenné prostredia v README súboroch projektov
### Python projekty
@ -348,61 +348,61 @@ CO_OP_TRANSLATOR_METADATA:
### Prístup k GitHub Models
- Potrebné sú Personal Access Tokens (PAT)
- Tokeny ukladajte ako environmentálne premenné
- Nikdy necommitujte tokeny alebo prihlasovacie údaje
- Osobné prístupové tokeny (PAT) sú potrebné pre GitHub Models
- Tokeny by mali byť uložené ako premenné prostredia
- Nikdy necommitujte tokeny alebo poverenia
## Ďalšie poznámky
### Cieľová skupina
### Cieľové publikum
- Úplní začiatočníci vo webovom vývoji
- Študenti a samoukovia
- Učitelia používajúci kurikulum v triedach
- Obsah navrhnutý pre prístupnosť a postupné nadobúdanie zručností
- Študenti a samouci
- Učitelia používajúci učebný plán v triedach
- Obsah je navrhnutý pre prístupnosť a postupné budovanie zručností
### Edukačná filozofia
### Vzdelávacia filozofia
- Prístup založený na projektoch
- Časté kontrolné otázky (kvízy)
- Praktické programovacie cvičenia
- Príklady z reálneho sveta
- Dôraz na základy pred frameworkami
- Prístup založený na učení sa cez projekty
- Časté kontroly vedomostí (kvízy)
- Praktické cvičenia v kódovaní
- Príklady reálnych aplikácií
- Zameranie na základy pred frameworkmi
### Údržba úložiska
### Údržba repozitára
- Aktívna komunita študentov a prispievateľov
- Pravidelné aktualizácie závislostí a obsahu
- Správa issues a diskusií od správcov
- Automatické aktualizácie prekladov cez GitHub Actions
- Issues a diskusie sú monitorované maintainerami
- Aktualizácie prekladov automatizované cez GitHub Actions
### Súvisiace zdroje
- [Microsoft Learn moduly](https://docs.microsoft.com/learn/)
- [Student Hub zdroje](https://docs.microsoft.com/learn/student-hub/)
- [Zdroje Student Hub](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) odporúčaný pre študentov
- Ďalšie kurzy: Generatívna AI, Data Science, ML, IoT kurikulum dostupné
- Ďalšie kurzy: Generative AI, Data Science, ML, IoT učebné osnovy sú dostupné
### Práca so špecifickými projektmi
### Práca s konkrétnymi projektmi
Pre podrobné inštrukcie k jednotlivým projektom si pozrite README súbory v:
Pre podrobné inštrukcie k jednotlivým projektom sa odkazujte na README súbory v:
- `quiz-app/README.md` - Vue 3 kvízová aplikácia
- `7-bank-project/README.md` - Banková aplikácia s autentifikáciou
- `5-browser-extension/README.md` - Vývoj rozšírení prehliadača
- `5-browser-extension/README.md` - Vývoj rozšírenia prehliadača
- `6-space-game/README.md` - Vývoj hry založenej na Canvas
- `9-chat-project/README.md` - AI chat asistent projekt
- `9-chat-project/README.md` - Projekt AI chat asistenta
### Štruktúra monorepa
Aj keď nejde o tradičné monorepo, toto úložisko obsahuje viacero nezávislých projektov:
Aj keď nejde o tradičné monorepo, tento repozitár obsahuje viacero nezávislých projektov:
- Každá lekcia je samostatná
- Projekty nezdieľajú závislosti
- Pracujte na jednotlivých projektoch bez ovplyvnenia ostatných
- Naklonujte celé repo pre plné kurikulumové skúsenosti
- Naklonujte celý repozitár pre kompletnú skúsenosť s učebným plánom
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Upozornenie**:
Tento dokument bol preložený pomocou AI prekladateľskej služby [Co-op Translator](https://github.com/Azure/co-op-translator). Aj keď sa snažíme o presnosť, treba mať na pamäti, že automatizované preklady môžu obsahovať chyby alebo nepresnosti. Originálny dokument v jeho pôvodnom jazyku by mal byť považovaný za autoritatívny zdroj. Pre kritické informácie sa odporúča profesionálny ľudský preklad. Nie sme zodpovední za akékoľvek nedorozumenia alebo nesprávne interpretácie vzniknuté z použitia tohto prekladu.
**Vylúčenie zodpovednosti**:
Tento dokument bol preložený pomocou služby prekladu založenej na umelej inteligencii [Co-op Translator](https://github.com/Azure/co-op-translator). Aj keď sa snažíme o presnosť, upozorňujeme, že automatické preklady môžu obsahovať chyby alebo nepresnosti. Pôvodný dokument v jeho rodnom jazyku by sa mal považovať za záväzný zdroj. Pre kritické informácie sa odporúča profesionálny ľudský preklad. Nie sme zodpovední za žiadne nedorozumenia alebo nesprávne výklady vyplývajúce z použitia tohto prekladu.
<!-- CO-OP TRANSLATOR DISCLAIMER END -->
Loading…
Cancel
Save