msb-public
/
Web-Dev-For-Beginners
mirror of https://github.com/microsoft/Web-Dev-For-Beginners.git
1
0
Code Issues Projects Releases Wiki Activity

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

Browse Source
pull/1774/head
localizeflow[bot] 6 months ago
parent 3dd0c15c92
commit 9346676db1
9 changed files with 1642 additions and 1642 deletions
Show Stats Download Patch File Download Diff File

6
translations/bg/.co-op-translator.json
Unescape View File

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

733
translations/bg/1-getting-started-lessons/1-intro-to-programming-languages/README.md
View File

File diff suppressed because it is too large Load Diff

348
translations/bg/AGENTS.md
Unescape View File

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

6
translations/ro/.co-op-translator.json
Unescape View File

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

786
translations/ro/1-getting-started-lessons/1-intro-to-programming-languages/README.md
View File

File diff suppressed because it is too large Load Diff

338
translations/ro/AGENTS.md
Unescape View File

@ -1,30 +1,30 @@
# AGENTS.md # 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 - **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) - **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 - **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 proiecte AI) - **Tehnologii**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (pentru proiectele AI)
### Arhitectură ### 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 - 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) - Sistem de traducere folosind GitHub Actions (co-op-translator)
- Documentație servită prin Docsify și disponibilă ca PDF - 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 ```bash
git clone https://github.com/microsoft/Web-Dev-For-Beginners.git 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 npm run lint # Rulează ESLint
``` ```
### API Proiect Bancar (Node.js + Express) ### API pentru proiectul Bank (Node.js + Express)
```bash ```bash
cd 7-bank-project/api cd 7-bank-project/api
@ -51,7 +51,7 @@ npm run lint # Rulează ESLint
npm run format # Formatează cu Prettier npm run format # Formatează cu Prettier
``` ```
### Proiecte Extensie Browser ### Proiecte Browser Extension
```bash ```bash
cd 5-browser-extension/solution cd 5-browser-extension/solution
@ -59,7 +59,7 @@ npm install
# Urmați instrucțiunile specifice browserului pentru încărcarea extensiilor # Urmați instrucțiunile specifice browserului pentru încărcarea extensiilor
``` ```
### Proiecte Joc Spațial ### Proiecte Space Game
```bash ```bash
cd 6-space-game/solution cd 6-space-game/solution
@ -67,7 +67,7 @@ npm install
# Deschide index.html în browser sau folosește Live Server # Deschide index.html în browser sau folosește Live Server
``` ```
### Proiect Chat (Backend Python) ### Proiect Chat (backend Python)
```bash ```bash
cd 9-chat-project/solution/backend/python cd 9-chat-project/solution/backend/python
@ -76,207 +76,207 @@ pip install openai
python api.py 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 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 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 5. Testează orice modificare de cod în directoarele proiectelor relevante
6. Trimite pull request-uri urmând ghidurile de contribuție 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 2. Navighează secvențial prin directoarele lecțiilor
3. Citește fișierele README pentru fiecare lecție 3. Citește fișierele README pentru fiecare lecție
4. Completează chestionarele pre-lecție la https://ff-quizzes.netlify.app/web/ 4. Completează chestionarele pre-lecție la https://ff-quizzes.netlify.app/web/
5. Parcurge exemplele de cod din dosarele lecțiilor 5. Parcurge exemplele de cod din folderele lecțiilor
6. Realizează temele și provocările 6. Finalizează temele și provocările
7. Completează chestionarele post-lecție 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 - **Quiz App**: Rulează `npm run dev` în directorul quiz-app
- **Proiecte**: Folosește extensia VS Code Live Server pentru proiectele HTML - **Proiecte**: Folosește extensia VS Code Live Server pentru proiectele HTML
- **Proiecte API**: Rulează `npm start` în directoarele API respective - **Proiecte API**: Rulează `npm start` în directoarele API respective
## Instrucțiuni de Testare ## Instrucțiuni de testare
### Testarea Quiz App ### Testare Quiz App
```bash ```bash
cd quiz-app cd quiz-app
npm run lint # Verifică problemele legate de stilul codului npm run lint # Verifică probleme de stil ale codului
npm run build # Verifică dacă build-ul reușește npm run build # Verifică dacă compilarea reușește
``` ```
### Testarea API Bancar ### Testare Bank API
```bash ```bash
cd 7-bank-project/api 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 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: - Testarea manuală se concentrează pe:
- Executarea corectă a exemplelor de cod fără erori - Exemplele de cod rulează fără erori
- Funcționarea corectă a linkurilor în documentație - Linkurile din documentație funcționează corect
- Finalizarea cu succes a construziunilor proiectelor - Build-urile proiectelor se finalizează cu succes
- Urmarea celor mai bune practici în exemple - Exemplele urmează bune practici
### Verificări înainte de Trimitere ### Verificări pre-trimitere
- Rulează `npm run lint` în directoarele cu package.json - 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 - 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 ### JavaScript
- Folosește sintaxa modernă ES6+ - Folosește sintaxa modernă ES6+
- Respectă configurațiile standard ESLint oferite în proiecte - Urmează configurațiile standard ESLint furnizate în proiecte
- Folosește nume semnificative de variabile și funcții pentru claritate educațională - Folosește nume semnificative pentru variabile și funcții pentru claritate educațională
- Adaugă comentarii care explică conceptele pentru învățăcei - Adaugă comentarii care explică conceptele pentru cursanți
- Formatează cu Prettier unde este configurat - Formatează folosind Prettier acolo unde este configurat
### HTML/CSS ### HTML/CSS
- Elemente semantice HTML5 - Elemente semantice HTML5
- Principii de design responsive - Principii de design responsive
- Convenții clare de denumire a claselor - Convenții clare de denumire a claselor
- Comentarii care explică tehnicile CSS pentru învățăcei - Comentarii care explică tehnicile CSS pentru cursanți
### Python ### Python
- Respectă ghidurile stil PEP 8 - Ghiduri de stil PEP 8
- Exemple clare și educaționale de cod - Exemple de cod clare și educaționale
- Hinturi de tipuri acolo unde sunt utile pentru învățare - Hint-uri de tipare acolo unde sunt utile pentru învățare
### Documentație Markdown ### Documentație Markdown
- Ierarhie clară a titlurilor - Ierarhie clară a titlurilor
- Blocuri de cod cu specificarea limbajului - Blocuri de cod cu specificație a limbajului
- Linkuri către resurse suplimentare - Linkuri către resurse suplimentare
- Capturi de ecran și imagini în directoarele `images/` - Capturi de ecran și imagini în directoarele `images/`
- Text alternativ pentru imagini pentru accesibilitate - 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.) - Lecțiile numerotate secvențial (1-getting-started-lessons, 2-js-basics, etc.)
- Fiecare proiect are directoare `solution/` și adesea `start/` sau `your-work/` - Fiecare proiect are `solution/` și adesea `start/` sau `your-work/` directoare
- Imaginile stocate în foldere specifice lecțiilor, `images/` - Imaginile stocate în foldere `images/` specifice lecțiilor
- Traduceri în structura `translations/{language-code}/` - 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 ```bash
cd quiz-app cd quiz-app
npm run build # Creează folderul dist/ 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: Azure Static Web Apps configuration:
- **Locația aplicației**: `/quiz-app` - **App location**: `/quiz-app`
- **Locația outputului**: `dist` - **Output location**: `dist`
- **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml` - **Workflow**: `.github/workflows/azure-static-web-apps-ashy-river-0debb7803.yml`
### Generare PDF Documentație ### Generare PDF pentru documentație
```bash ```bash
npm install # Instalează docsify-to-pdf npm install # Instalează docsify-to-pdf
npm run convert # Generează PDF din docs npm run convert # Generează PDF din documentație
``` ```
### Documentație Docsify ### Documentație Docsify
```bash ```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 docsify serve # Servește pe localhost:3000
``` ```
### Construiri specifice proiectului ### Build-uri specifice proiectelor
Fiecare director de proiect poate avea propriul proces de construire: Fiecare director de proiect poate avea propriul proces de build:
- Proiecte Vue: `npm run build` creează bundle-uri de producție - Proiecte Vue: `npm run build` creează bundle-uri pentru producție
- Proiecte statice: fără pas de construire, fișiere servite direct - 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: Folosește titluri clare și descriptive care indică aria modificării:
- `[Quiz-app] Adaugă chestionar nou pentru lecția X` - `[Quiz-app] Add new quiz for lesson X`
- `[Lesson-3] Corectează greșeală în proiectul terrarium` - `[Lesson-3] Fix typo in terrarium project`
- `[Translation] Adaugă traducerea în spaniolă pentru lecția 5` - `[Translation] Add Spanish translation for lesson 5`
- `[Docs] Actualizează instrucțiunile de configurare` - `[Docs] Update setup instructions`
### Verificări Necesare ### Verificări necesare
Înainte de a trimite un PR: Înainte de a trimite un PR:
1. **Calitate cod**: 1. **Calitatea codului**:
- Rulează `npm run lint` în directoarele proiectelor afectate - Rulează `npm run lint` în directoarele proiectului afectate
- Rezolvă toate erorile și avertismentele lint - Remediază toate erorile și avertismentele de lint
2. **Verificare construire**: 2. **Verificare build**:
- Rulează `npm run build` dacă este cazul - Rulează `npm run build` dacă este aplicabil
- Asigură-te că nu apar erori la construire - Asigură-te că nu există erori de build
3. **Validare linkuri**: 3. **Validare linkuri**:
- Testează toate linkurile markdown - Testează toate linkurile markdown
- Verifică referințele imaginii funcționează - Verifică referințele la imagini
4. **Revizuire conținut**: 4. **Revizuire conținut**:
- Corectează ortografia și gramatica - Verifică ortografia și gramatica
- Asigură integritatea și claritatea educațională a exemplelor - Asigură-te că exemplele de cod sunt corecte și educaționale
- Verifică că traducerile păstrează sensul original - 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) - Acceptă Microsoft CLA (verificare automată la primul PR)
- Respectă [Codul de Conduită Open Source Microsoft](https://opensource.microsoft.com/codeofconduct/) - Urmează [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
- Consultă [CONTRIBUTING.md](./CONTRIBUTING.md) pentru ghiduri detaliate - Vezi [CONTRIBUTING.md](./CONTRIBUTING.md) pentru ghiduri detaliate
- Referințează numere de issue în descrierea PR-ului dacă este cazul - 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 - PR-urile sunt revizuite de maintaineri și comunitate
- Se prioritizează claritatea educațională - Claritatea educațională este prioritară
- Exemplele de cod trebuie să urmeze cele mai bune practici actuale - Exemplele de cod trebuie să urmeze bune practici actuale
- Traducerile sunt revizuite pentru acuratețe și adecvare culturală - 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 - 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 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}/` 1. Localizează fișierul în `translations/{language-code}/`
2. Fă îmbunătățiri păstrând structura 2. Fă îmbunătățiri păstrând structura
3. Asigură-te că exemplele de cod rămân funcționale 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 ```markdown
<!-- <!--
CO_OP_TRANSLATOR_METADATA: 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**: **Quiz app nu pornește**:
- Verifică versiunea Node.js (recomandat v14+) - Verifică versiunea Node.js (recomandat v14+)
- Șterge `node_modules` și `package-lock.json`, rulează din nou `npm install` - Șterge `node_modules` și `package-lock.json`, rulează `npm install` din nou
- Verifică conflicte de port (implicit: Vite folosește port 5173) - Verifică conflictele de port (implicit: Vite folosește portul 5173)
**Server API nu pornește**: **Serverul API nu pornește**:
- Asigură versiunea minimă Node.js (node >=10) - Verifică dacă versiunea Node.js îndeplinește minimul (node >=10)
- Verifică dacă portul este deja folosit - 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ă**: **Browser extension nu se încarcă**:
- Verifică formatul corect al manifest.json - Verifică dacă manifest.json este formatat corect
- Verifică consola browser pentru erori - Verifică consola browser-ului pentru erori
- Urmează instrucțiunile specifice browser-ului pentru instalare extensie - Urmează instrucțiunile specifice browser-ului pentru instalarea extensiei
**Probleme proiect chat Python**: **Probleme proiect chat Python**:
- Asigură pachetul OpenAI instalat: `pip install openai` - Asigură-te că pachetul OpenAI este instalat: `pip install openai`
- Verifică că variabila de mediu GITHUB_TOKEN este setată - Verifică variabila de mediu GITHUB_TOKEN este setată
- Verifică permisiunile de acces GitHub Models - Verifică permisiunile de acces GitHub Models
**Docsify nu servește documentația**: **Docsify nu servește documentația**:
- Instalează docsify-cli global: `npm install -g docsify-cli` - Instalează docsify-cli global: `npm install -g docsify-cli`
- Rulează din directorul rădăcină al depozitului - Rulează din directorul rădăcină al repository-ului
- Verifică existența fișierului `docs/_sidebar.md` - Verifică că `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 - Folosește VS Code cu extensia Live Server pentru proiectele HTML
- Instalează extensiile ESLint și Prettier pentru formatare constantă - Instalează extensiile ESLint și Prettier pentru format consistent
- Folosește DevTools din browser pentru depanare JavaScript - Folosește DevTools din browser pentru depanarea JavaScript
- Pentru proiecte Vue, instalează extensia Vue DevTools pentru browser - 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 - Numărul mare de fișiere traduse (50+ de limbi) înseamnă că clone-urile complete sunt mari
- Folosește shallow clone dacă lucrezi doar pe conținut: `git clone --depth 1` - 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ținut în engleză - Exclude traducerile din căutări când lucrezi pe conținutul în engleză
- Procesele de construire pot fi lente la prima execuție (npm install, construcție Vite) - 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 - Cheile API nu trebuie niciodată comise în repository
- Folosește fișiere `.env` (deja incluse în `.gitignore`) - Folosește fișiere `.env` (sunt deja în `.gitignore`)
- Documentează variabilele de mediu necesare în README-urile proiectelor - Documentează variabilele de mediu necesare în README-urile proiectelor
### Proiecte Python ### Proiecte Python
- Folosește medii virtuale: `python -m venv venv` - Folosește medii virtuale: `python -m venv venv`
- Menține dependențele actualizate - Păstrează dependențele actualizate
- Tokenii GitHub trebuie să aibă permisiuni minime necesare - Token-urile GitHub ar trebui să aibă permisiunile minime necesare
### Acces GitHub Models ### Acces GitHub Models
- Se cer Tokenuri Personale de Acces (PAT) pentru GitHub Models - Personal Access Tokens (PAT) necesare pentru GitHub Models
- Tokenii trebuie stocați ca variabile de mediu - Token-urile ar trebui stocate ca variabile de mediu
- Nu comite niciodată tokenuri sau credențiale - 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 - Studenți și autodidacți
- Profesori care folosesc curriculumul în săli de clasă - Profesori care folosesc curriculumul în sălile de clasă
- Conținut conceput pentru accesibilitate și dezvoltare graduală a abilităților - 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) - Verificări frecvente ale cunoștințelor (chestionare)
- Exerciții practice de programare - Exerciții practice de codare
- Exemple de aplicare în lumea reală - Exemple de aplicații din lumea reală
- Accent pe fundamente înainte de framework-uri - Accent pe elementele fundamentale înaintea framework-urilor
### Mentenanța Depozitului ### Mentenanța repository-ului
- Comunitate activă de învățăcei și contribuitori - Comunitate activă de cursanți și contributori
- Actualizări regulate la dependențe și conținut - Actualizări regulate ale dependențelor și conținutului
- Probleme și discuții monitorizate de mentori - Issue-uri și discuții monitorizate de maintaineri
- Actualizări traduceri automate prin GitHub Actions - Actualizările de traducere automatizate prin GitHub Actions
### Resurse Relatate ### Resurse conexe
- [Module Microsoft Learn](https://docs.microsoft.com/learn/) - [Microsoft Learn modules](https://docs.microsoft.com/learn/)
- [Resurse Student Hub](https://docs.microsoft.com/learn/student-hub/) - [Student Hub resources](https://docs.microsoft.com/learn/student-hub/)
- [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) recomandat pentru învățăcei - [GitHub Copilot](https://marketplace.visualstudio.com/items?itemName=GitHub.copilot) recomandat pentru cursanți
- Cursuri suplimentare: AI Generativ, Data Science, ML, curricula IoT disponibile - 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: Pentru instrucțiuni detaliate despre proiectele individuale, consultă fișierele README din:
- `quiz-app/README.md` - aplicație quiz Vue 3 - `quiz-app/README.md` - Vue 3 quiz application
- `7-bank-project/README.md` - aplicație bancară cu autentificare - `7-bank-project/README.md` - Banking application with authentication
- `5-browser-extension/README.md` - dezvoltare extensie browser - `5-browser-extension/README.md` - Browser extension development
- `6-space-game/README.md` - dezvoltare joc pe canvas - `6-space-game/README.md` - Canvas-based game development
- `9-chat-project/README.md` - proiect asistent AI chat - `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ă - Fiecare lecție este autonomă
- Proiectele nu împart dependențe - Proiectele nu împart dependențe
- Lucrează pe proiecte individuale fără a afecta altele - Lucrează la proiecte individuale fără a afecta altele
- Clonează întregul depozit pentru experiența completă a curriculumului - Clonează întregul repo pentru experiența completă a curriculumului
--- ---
<!-- CO-OP TRANSLATOR DISCLAIMER START --> <!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Declinare de responsabilitate**: **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 --> <!-- CO-OP TRANSLATOR DISCLAIMER END -->

6
translations/sk/.co-op-translator.json
Unescape View File

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

737
translations/sk/1-getting-started-lessons/1-intro-to-programming-languages/README.md
View File

File diff suppressed because it is too large Load Diff

324
translations/sk/AGENTS.md
Unescape View File

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