Това е образователно хранилище за учебна програма за обучението на начинаещи по основи на уеб разработката. Учебната програма представлява изчерпателен курс от 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 структурирани урока, организирани в курсови модули с проекти
- **Практически проекти**: Терариум, Игра за писане, Разширение за браузър, Космическа игра, Банково приложение, Редактор на код и AI чат асистент
- **Интерактивни викторини**: 48 викторини с по 3 въпроса всяка (оценка преди/следурок)
- **Многоезична поддръжка**: Автоматизирани преводи на 50+ езика чрез GitHub Actions
- **Технологии**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (за AI проекти)
### Архитектура
- Образователно хранилище със структура, базирана на уроци
- Всяка папка с урок съдържа README, кодови примери и решения
- Самостоятелни проекти в отделни директории (quiz-app, различни проектни уроци)
- Система за преводс помощта на GitHub Actions (co-op-translator)
- Документация, обслужвана чрез Docsify и достъпна като PDF
- Образователно хранилище със структура базирана на уроци
- Всяка папка с урок съдържа README, примерис код и решения
- Самостоятелни проекти в отделни директории (quiz-app, различни проекти от уроци)
- Система за превод, използваща GitHub Actions (co-op-translator)
- Документация, достъпна чрез Docsify и като PDF
## Команди за настройка
Това хранилище е основно за консумация на образователно съдържание. За работа със специфични проекти:
Това хранилище е основно за консумация на образователно съдържание. За работа с конкретни проекти:
### Основна настройка на хранилището
@ -37,7 +37,7 @@ cd Web-Dev-For-Beginners
cd quiz-app
npm install
npm run dev # Стартиране на сървър за разработка
npm run build # Създаване за продукция
npm run build # Създаване на продукционна версия
npm run lint # Стартиране на ESLint
```
@ -59,15 +59,15 @@ npm install
# Следвайте инструкциите за зареждане на разширения, специфични за браузъра
```
### Проекти за Space Game
### Проекти за космическа игра
```bash
cd 6-space-game/solution
npm install
# Отворете index.html в браузър или използвайте Live Server
# Отворете index.html в браузъра или използвайте Live Server
```
### Проект Chat (Python Backend)
### Чат проект (Python Back-end)
```bash
cd 9-chat-project/solution/backend/python
@ -76,33 +76,33 @@ pip install openai
python api.py
```
## Работен процес на разработка
## Работен процес при разработка
### Задопринасящите съдържание
### Засътрудници по съдържанието
1. **Направете форк на хранилището** в акаунта си в GitHub
2. **Клонирайте вашия форк** локално
1. **Клонирайте хранилището** във вашия GitHub акаунт
2. **Клонирайте вашето копие** локално
3. **Създайте нов клон** за вашите промени
4. Направете промени в съдържанието на урока или кодовите примери
5. Тествайте всякакви кодови промени в съответните проектни директории
6. Изпратете Pull Request следвайки указанията за принос
4. Направете промени в съдържанието на уроците или примерите с код
5. Тествайте промените в съответните директории с проекти
6. Подайте pull заявки, следвайки указанията за принос
### За учащите
### За учащи
1. Направете форк или клонирайте хранилището
2. Навигирайте послойно в директориите с уроци
1. Fork или клонирайте хранилището
2. Навигирайте през папките с уроци последователно
3. Прочетете README файловете за всеки урок
4. Попълнете предварителните викторини на https://ff-quizzes.netlify.app/web/
5. Работете с кодовите примери в папките с уроци
6. Изпълнете задачи и предизвикателства
7. Попълнете следурочните викторини
5. Работас примерите с код в папките на уроците
6. Завършете задачи и предизвикателства
7. Вземете следурочни викторини
### Живо разработване
### Жива разработка
- **Документация**: Стартирайте `docsify serve` в корена (порт 3000)
- **Документация**: Стартирайте `docsify serve` в основната папка (порт 3000)
- **Quiz App**: Стартирайте `npm run dev` в директорията quiz-app
- **Проекти**: Използвайте разширението VS Code Live Server за HTML проекти
- **API Проекти**: Стартирайте `npm start` в съответните API директории
- **API проекти**: Стартирайте `npm start` в съответните API директории
## Инструкции за тестване
@ -110,8 +110,8 @@ python api.py
```bash
cd quiz-app
npm run lint # Проверка за проблеми със стила на кода
npm run build # Проверка дали изграждането е успешно
npm run lint # Проверете за проблеми със стила на кода
npm run build # Уверете се, че компилацията е успешна
```
### Тестване на Bank API
@ -119,34 +119,34 @@ npm run build # Проверка дали изграждането еус
```bash
cd 7-bank-project/api
npm run lint # Проверете за проблеми със стила на кода
node server.js # Проверете дали сървърът стартира без грешки
node server.js # Потвърдете, че сървърът стартира без грешки
```
### Общ подход към тестването
- Това е образователно хранилище без изчерпателни автоматизирани тестове
- Ръчното тестване се фокусира върху:
- Кодови примери, които се изпълняват без грешки
- Връзки в документацията работят правилно
- Проектите се изграждат успешно
- Примерите следват най-добрите практики
- Ръчно тестване се фокусира върху:
- Примерите с код да стартират без грешки
- Линковете в документацията да работят коректно
- Проектите да се компилират успешно
- Примерите да следват добри практики
### Проверки преди изпращане
### Проверки преди подаване
- Стартирайте `npm run lint` в директории с package.json
- Проверете дали линковете в markdown са валидни
- Тествайте кодовите примери в браузър или Node.js
- Проверете дали преводите запазват правилната структура
- Проверете валидността на markdown линковете
- Тествайте примерите с код в браузър или Node.js
- Уверете се, че преводите са структурирани правилно
## Насоки за стил на кода
### JavaScript
- Използвайте съвременен синтаксис ES6+
- Следвайте стандартните ESLint конфигурации в проектите
- Използвайте смислени имена на променливи и функции за яснота при учене
- Използвайте съвременен ES6+ синтаксис
- Спазвайте стандартните ESLint конфигурации в проектите
- Използвайте смислени имена на променливи и функции за образователна яснота
- Добавяйте коментари, обясняващи концепциите за учащите
За подробни инструкции за индивидуалните проекти вижте README файловете в:
- `quiz-app/README.md` - Vue 3 quiz приложение
- `7-bank-project/README.md` - Банково приложение с автентикация
- `5-browser-extension/README.md` - Разработка на браузър разширения
- `6-space-game/README.md` - Разработка на игра базирана на Canvas
- `9-chat-project/README.md` - AI чат асистент проект
- `5-browser-extension/README.md` - Разработка на браузърно разширение
- `6-space-game/README.md` - Разработка на игра със Canvas
- `9-chat-project/README.md` - Chat асистент с AI
### Структура на монохранилище
Въпреки че не е традиционно монохранилище, това хранилище съдържа множество независими проекти:
- Всеки урок е самостоятелен
- Проектите не споделят зависимости
- Работете по отделни проекти без да влияете на другите
- Работете по отделни проекти без да влияете на други
- Клонирайте цялото хранилище за пълния учебен опит
---
<!-- 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). Въпреки че се стремим към точност, моля, имайте предвид, че автоматизираните преводи могат да съдържат грешки или неточности. Оригиналният документ на неговия роден език трябва да се счита за авторитетен източник. За критична информация се препоръчва професионален човешки превод. Не носим отговорност за каквито и да енедоразумения или неправилни тълкувания, произтичащи от използването на този превод.
Acesta este un depozit curricular educațional pentru predarea bazelor dezvoltării web începătorilor. Curriculumul este un curs cuprinzător de 12 săptămâni, dezvoltat de Microsoft Cloud Advocates, care cuprinde 24 de lecții practice ce acoperă JavaScript, CSS și HTML.
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.
### Componente cheie
- **Conținut educațional**: 24 de lecții structurate organizate în module bazate pe proiecte
- **Proiecte practice**: Terrarium, Joc de tastare, Extensie browser, Joc spațial, Aplicație bancară, Editor de cod și Asistent AI pentru chat
- **Teste interactive**: 48 de teste cu câte 3 întrebări fiecare (evaluări înainte și după lecție)
- **Suport multilingv**: Traduceri automate în peste 50 de limbi prin GitHub Actions
- `6-space-game/README.md` - dezvoltare joc pe canvas
- `9-chat-project/README.md` - proiect asistent AI pentru chat
- `6-space-game/README.md` - dezvoltare joc bazat pe canvas
- `9-chat-project/README.md` - proiect asistent chat AI
### Structura Monorepo
Deși nu este un monorepo tradițional, acest depozit conține mai multe proiecte independente:
- Fiecare lecție este autonomă
- Proiectele nu împart dependențe
- Lucrați pe proiecte individuale fără a afecta altele
- Clonați întregul repo pentru experiența completă a curriculumului
- Lucrează pe proiecte individuale fără a afecta altele
- Clonează întregul depozit pentru experiența completă a curriculumului
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Declinare de responsabilitate**:
Acest document a fost tradus folosind serviciul de traducere automată AI [Co-op Translator](https://github.com/Azure/co-op-translator). Deși ne străduim să asigurăm acuratețea, 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 autoritară. Pentru informații critice, se recomandă traducerea profesională realizată de un specialist uman. Nu ne asumăm răspunderea pentru neînțelegeri sau interpretări eronate rezultate din utilizarea acestei traduceri.
**Declinare a responsabilității**:
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 autoritară. Pentru informații critice, se recomandă traducerea profesională realizată de un specialist uman. Nu ne asumăm răspunderea pentru eventuale neînțelegeri sau interpretări greșite rezultate din utilizarea acestei traduceri.
Ово је репозиторијум едукативног програма за подучавање основа веб развоја почетницима. Програм је свеобухватан курс у трајању од 12 недеља који је развио Microsoft Cloud Advocates, и садржи 24 практична часа који покривају JavaScript, CSS и HTML.
Ово је репозиторјум образовног наставног плана за учење основа веб развоја за почетнике. Наставни план је обиман курс од 12 недеља развијен од стране Microsoft Cloud Advocates тима, који садржи 24 практична часа који покривају JavaScript, CSS и HTML.
### Кључне компоненте
### Кључне Компоненте
- **Едукативни садржај**: 24 структуирана часа организована у модуле базиране на пројектима
- **Практични пројекти**: Терраријум, Игра куцања, Прегледачки екстензија, Игрица у свемиру, Банкарска апликација, Уредник кода и AI помоћник за разговор
- **Интерактивни квизови**: 48 квизова са по 3 питања (пре и после часа)
- **Подршка за више језика**: Аутоматизовани преводи за 50+ језика преко GitHub Actions
- **Образовни садржај**: 24 структуирана часа организована у модуле засноване на пројектима
- **Практични пројекти**: Terrarium, Typing Game, Browser Extension, Space Game, Banking App, Code Editor, и AI Chat Assistant
- **Интерактивни квизови**: 48 квизова са по 3 питања (процена пре и после часа)
- **Подршка више језика**: Аутоматски преводи за 50+ језика преко GitHub Actions
- **Технологије**: HTML, CSS, JavaScript, Vue.js 3, Vite, Node.js, Express, Python (за AI пројекте)
### Архитектура
- Едукативни репозиторијум са структуром заснованом на часовима
- Свака фасцикла са часом садржи README, примере кода и решења
- Самостални пројекти у посебним директоријумима (quiz-app, различити пројекти часова)
- Образовни репозиторјум са структуром заснованом на часовима
- Свака фасцикла часа садржи README, примере кода и решења
- Самостални пројекти у посебним фасциклама (quiz-app, разни пројекти часова)
- Систем за превођење користећи GitHub Actions (co-op-translator)
- Документација послужена преко Docsify и доступна као PDF
- Документација служи преко Docsify и доступна јеу PDF формату
## Команде за подешавање
## Команде за Поставку
Овај репозиторијум је првенствено за конзумирање едукативног садржаја. За рад са специфичним пројектима:
Овај репозиторјум је првенствено за конзумирање образовног садржаја. За рад са одређеним пројектима:
За детаљна упутства о појединачним пројектима, погледајте README фајлове у:
- `quiz-app/README.md` - Vue 3 квиз апликација
- `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 помоћник за разговор
- `5-browser-extension/README.md` - Развој прегледачких додатака
- `6-space-game/README.md` - Развој игре на Canvas елементу
- `9-chat-project/README.md` - AI асистент за чет
### Монорепо структура
### Структура монорепозиторијума
Иако није традиционално монорепо, овај репозиторијум садржи више независних пројеката:
Иако није класичан монорепозиторијум, овај репозиторјум садржи више независних пројеката:
- Сваки час је самосталан
- Пројекти не деле зависности
- Рад на појединачним пројектима без утицаја на остале
- Клонирајте цео репозиторијум за пун доживљај програма
- Радите на појединачним пројектима без утицаја на остале
- Клонирајте цео репозиторјум за потпуно искуство наставног плана
---
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
**Одрицање од одговорности**:
Овај документ је преведен коришћењем АИ преводилачке услуге [Co-op Translator](https://github.com/Azure/co-op-translator). Иако тежимо прецизности, молимо вас да имате у виду да аутоматски преводи могу садржати грешке или нетачности. Првобитни документ на његовом изворном језику треба сматрати ауторитетним извором. За критичне информације препоручује се професионални људски превод. Нисмо одговорни за било каква неспоразума или погрешне интерпретације настале употребом овог превода.
**Одрицање одговорности**:
Овај документ је преведен помоћу АИ услуге за превођење [Co-op Translator](https://github.com/Azure/co-op-translator). Иако тежимо тачности, молимо имајте у виду да аутоматски преводи могу садржати грешке или нетачности. Изворни документ на његовом матерњем језику треба сматрати ауторитетом. За критичне информације препоручује се професионални људски превод. Нисмо одговорни за било каква неспоразума или погрешна тумачења која произилазе из коришћења овог превода.