Merge pull request #2 from DjangoGirls/master

Update from master origin

.bookignore

@@ -0,0 +1,6 @@
+.bookignore
+.github
+.gitignore
+crowdin.yaml
+package-lock.json
+package.json

.github/CODEOWNERS

@@ -2,17 +2,22 @@
 *	@DjangoGirls/committers
 
 # language PR review teams for the respective translations:
+/bg/	@DjangoGirls/bg-pr
+/cs/	@DjangoGirls/cs-pr
 /de/	@DjangoGirls/de-pr
+/el/	@DjangoGirls/el-pr
 /en/	@DjangoGirls/en-pr
 /es/	@DjangoGirls/es-pr
 /fa/	@DjangoGirls/fa-pr
 /fr/	@DjangoGirls/fr-pr
+/hu/	@DjangoGirls/hu-pr
 /it/	@DjangoGirls/it-pr
 /ja/	@DjangoGirls/ja-pr
 /ko/	@DjangoGirls/ko-pr
 /pl/	@DjangoGirls/pl-pr
 /pt/	@DjangoGirls/pt-pr
 /ru/	@DjangoGirls/ru-pr
+/sk/	@DjangoGirls/sk-pr
 /tr/	@DjangoGirls/tr-pr
 /uk/	@DjangoGirls/uk-pr
 /zh/	@DjangoGirls/zh-pr

.github/workflows/deploy.yml

@@ -0,0 +1,27 @@
+name: Build and Deploy
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  build-and-deploy:
+    runs-on: ubuntu-latest
+    if: github.repository == 'djangogirls/tutorial'
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          persist-credentials: false
+
+      - name: Install and Build
+        run: |
+          npm install
+          npx honkit build
+
+      - name: Deploy
+        uses: JamesIves/github-pages-deploy-action@releases/v3
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          BRANCH: gh-pages
+          FOLDER: _book

.github/workflows/test.yml

@@ -0,0 +1,17 @@
+name: Build
+on:
+  - pull_request
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+        with:
+          persist-credentials: false
+
+      - name: Install and Build
+        run: |
+          npm install
+          npx honkit build

.gitignore

@@ -2,5 +2,6 @@ MANIFEST
 .DS_Store
 _book
 node_modules
+package-lock.json
 .idea
 .swp

CNAME

@@ -0,0 +1 @@
+tutorial.djangogirls.org

LANGS.md

@@ -1,4 +1,5 @@
 * [🇺🇸 English](en/)
+* [🇧🇬 Български (beta)](bg/)
 * [🇨🇿 Čeština (beta)](cs/)
 * [🇩🇪 Deutsch](de/)
 * [🇬🇷 Ελληνικά (beta)](el/)

bg/GLOSSARY.md

@@ -0,0 +1,3 @@
+# редактор на код
+
+Редакторът на код е приложение, което ти позволява да съхраняваш своя код за да можеш да продължиш с него по-късно. Може да научиш откъде да свалиш от [главата Редактор на код](./code_editor/README.md)

bg/README.md

@@ -0,0 +1,51 @@
+# Django Girls ръководство
+
+[![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial)
+
+> Тази работа е лицензирана под Creative Commons Attribution-ShareAlike 4.0 International License. За да видите копие на този лиценз, посетете https://creativecommons.org/licenses/by-sa/4.0/
+
+## Добре дошли
+
+Добре дошли в ръководството на Django Girls! Щастливи сме да те видим тук :) Ще те отведем на приключение зад кулисите на уеб-технологиите, като хвърлим бегъл поглед на всичко, което е необходимо за да накараме мрежата да проработи, така както я знаем.
+
+Както с всички непознати неща, това може да бъде малко трудно. Но не се притеснявай, вече имаш кураж да бъдеш тука, всичко ще бъде наред :)
+
+## Въведение
+
+Някога имал ли си чувтвото, че светът е свързан все повече и повече с технологиите и ти не си още част от него? Чудил ли си се как да създадеш уеб-сайт, но никога си нямал достатъчно мотивация да започнеш? Струвало ли ти се, че светът на софтуера е прекалено сложен за да започнеш да правиш нещо сам?
+
+Имаме добра новина за теб! Програмиране не е толкова трудно, колкото изглежда, и ние искаме да ти покажем колко лесно може да бъде това.
+
+Това ръководство няма магически да те превърне в програмист. Ако искаш да си добър ще ти трябват месеци или даже години учене и упражняване. Но ние искаме да покажем, че програмиране или създаване на уеб-сайтове не е толкова сложно, колкото изглежда. Ще се постараем да обясним в детайли, колкото се може по-добре, за да не се чувстваш уплашен от технологията.
+
+Надяваме се да те накараме да заобичаш технология толкова, колкото и ние я обичаме!
+
+## Какво ще научиш от това ръководство?
+
+След като приключиш с ръководството, ще имаш малко работещо уеб-приложение: твой собствен блог. Ще ти покажем как да го пуснеш в мрежата, така че другите да ти видят работата!
+
+Това ще изглежда (горе-долу) ето така:
+
+![Фигура 0.1](images/application.png)
+
+> Ако работиш с ръкводството сам, и нямаш инструктор който да ти помага в случай на някой проблем, имаме чат система за теб: [![Gitter](https://badges.gitter.im/DjangoGirls/tutorial.svg)](https://gitter.im/DjangoGirls/tutorial). Помолихме нашите инструктори и миналите участници да са там от време на време и да помагат на другите с ръководството! Не се страхувай да задаваш въпроси тука!
+
+Добре, [хайде да започнем от начало...](./how_the_internet_works/README.md)
+
+## Следвайки ръководството вкъщи
+
+Изумително е да си част от занятията на Django Girls, но също разбираме, че не винаги е възможно да присъстваш на някое от тях. Затова ние те насърчаваме да пробваш да следиш ръководството вкъщи. За читатели у дома, понастоящем приготвяме видеа, които ще улеснят следването на ръководството само по себе си. Проектът е все още в процес на обработка, но все повече и повече неща скоро ще бъдат покрити на [Coding is for girls](https://www.youtube.com/channel/UC0hNd2uW8jTR5K3KBzRuG2A/feed) YouTube канал.
+
+Във всяка вече покрита глава има линк, препращащ към съответното видео.
+
+## Относно и допринасяне
+
+Това ръководство е поддържано от [Django Girls](https://djangogirls.org/). Ако си намерил някакви грешки или искаш да актуализираш ръководството, моля, [следвай насоките за допринасяне](https://github.com/DjangoGirls/tutorial/blob/master/README.md).
+
+## Би ли искал да ни помогнеш да преведем ръководството на друг език?
+
+Понастоящем, преводите се съхраняват на платформа crowdin.com на този адрес:
+
+https://crowdin.com/project/django-girls-tutorial
+
+Ако твоят език не е изброен на [crowdin](https://crowdin.com/), моля [оставете заявка](https://github.com/DjangoGirls/tutorial/issues/new), информирайки ни за езика, за да можем да го добавим.

bg/SUMMARY.md

@@ -0,0 +1,35 @@
+# Обобщение
+
+* [Въведение](README.md)
+* [Инсталиране](installation/README.md) 
+  * [Команден ред](installation/README.md#command-line)
+  * [Python](installation/README.md#python)
+  * [Редактор на код](installation/README.md#code-editor)
+  * [Виртуална среда](installation/README.md#virtualenv)
+  * [Django](installation/README.md#django)
+  * [Git](installation/README.md#git)
+  * [GitHub](installation/README.md#github)
+  * [PythonAnywhere](installation/README.md#pythonanywhere)
+* [Инсталиране (chromebook)](chromebook_setup/README.md)
+* [Как работи интернет](how_the_internet_works/README.md)
+* [Въведение в команден ред](intro_to_command_line/README.md)
+* [Инсталиране на Python](python_installation/README.md)
+* [Редактор на код](code_editor/README.md)
+* [Въведение в Python](python_introduction/README.md)
+* [Какво е Django?](django/README.md)
+* [Инсталиране на Django](django_installation/README.md)
+* [Вашият първи проект с Django!](django_start_project/README.md)
+* [Django модели](django_models/README.md)
+* [Администриране на Django](django_admin/README.md)
+* [Внедряване!](deploy/README.md)
+* [Django URL адреси](django_urls/README.md)
+* [Django изгледи - време за създаване!](django_views/README.md)
+* [Въведение в HTML](html/README.md)
+* [Django ORM (Querysets)](django_orm/README.md)
+* [Динамични данни в шаблони](dynamic_data_in_templates/README.md)
+* [Django шаблони](django_templates/README.md)
+* [CSS - направи го красиво](css/README.md)
+* [Разширяване на шаблони](template_extending/README.md)
+* [Разшири своето приложение](extend_your_application/README.md)
+* [Django Форми](django_forms/README.md)
+* [Какво следва?](whats_next/README.md)

bg/chromebook_setup/README.md

@@ -0,0 +1,5 @@
+# Настройка на Chromebook
+
+> **Бележка** Ако вече сте минали през стъпките за инсталиране, няма нужда да правите това отново - можете да прескочите направо към [Въведение в Python](../python_introduction/README.md).
+
+{% include "/chromebook_setup/instructions.md" %}

bg/chromebook_setup/instructions.md

@@ -0,0 +1,73 @@
+Можеш да [пропуснеш този раздел](http://tutorial.djangogirls.org/en/installation/#install-python), ако не използваш Chromebook. Ако използвате, опитът ви в инсталацията ще бъде малко по-различен. Можете да игнорирате останалата част от инструкциите за инсталиране.
+
+### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9)
+
+Cloud IDE е инструмент, който ти дава редактор на код и достъп до компютър, работещ с Интернет, където можеш да инсталираш, пишеш и пускаш софтуер. За продължителността на ръководството, cloud IDE ще ти служи като твоя *локална машина*. Все пак ще пишеш команди в терминал, също като твоите съученици на OS X, Ubuntu или Windows, но той ще бъде свързан с компютър, работещ някъде другаде, който cloud IDE прави за теб. Ето инструкциите за cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9). Можете да изберете един от cloud IDE интерфейси и да следвате инструкциите за cloud IDE.
+
+#### PaizaCloud Cloud IDE
+
+1. Отиди на [PaizaCloud Cloud IDE](https://paiza.cloud/)
+2. Направи акаунт
+3. Натисни *New Server* и избери Django приложение
+4. Натисни бутон на Терминал (от лявата страна на прозореца)
+
+Сега трябва да виждаш интерфейс със странична лента, бутони са отляво. Натисни бутона "Terminal" за да ви отвори прозорец със следния надпис:
+
+{% filename %}Terminal{% endfilename %}
+
+    $
+
+
+Терминалът на PaizaCloud Cloud IDE е готов за твоите инструции. Можеш да увеличиш прозореца за да го направиш малко по-голям.
+
+#### AWS Cloud9
+
+Понастоящем, Cloud 9 изисква от теб да се регистрираш с AWS и да въведеш информация за кредитната си карта.
+
+1. Инсталирай Cloud 9 от [Chrome web store](https://chrome.google.com/webstore/detail/cloud9/nbdmccoknlfggadpfkmcpnamfnbkmkcp)
+2. Отиди на [c9.io](https://c9.io) и натисни *Get started with AWS Cloud9*
+3. Регистрирай се за AWS акаунт (изисква информация за кредитна карта, но можеш да го използваш безплатно)
+4. В AWS Dashboard, напиши *Cloud9* в лентата за търсене и натисни
+5. В Cloud 9 таблото, натисни *Create environment*
+6. Наречи го *django-girls*
+7. Конфигурирайки настройките, избери *Create a new instance for environment (EC2)* за "Environment Type" и *t2.micro* "Instance type" (трябва да пише "Free-tier eligible."). Настройката за икономия на разходи по подразбиране е добре, също може да запазиш и другите както са по подразбиране.
+8. Натисни *Next step*
+9. Натисни *Create environment*
+
+Сега трябва да видите интерфейс със странична лента, голям основен прозорец с малко текст и малък прозорец в долната част, който изглежда като нещо подобно:
+
+{% filename %}bash{% endfilename %}
+
+    yourusername:~/workspace $
+
+
+Тази долна зона е вашият терминал. Можете да използвате терминала за изпращане на инструкции до отдалечения компютър Cloud 9. Можете да промените размера на прозореца, за да го направите малко по-голям.
+
+### Виртуална среда
+
+Виртуална среда (наричана още virtualenv) е като частна кутия, в която можем да запълним полезен компютърен код за проект, над който работим. Ние ги използваме, за да държим различните части от код, които искаме за отделните ни проекти, разделени, така че нещата да не се смесват между проектите.
+
+Пусни:
+
+{% filename %}Cloud 9{% endfilename %}
+
+    mkdir djangogirls
+    cd djangogirls
+    python3.6 -mvenv myvenv
+    source myvenv/bin/activate
+    pip install django~={{ book.django_version }}
+
+
+(имайте предвид, че на последния ред използваме тилд, последван от знак за равенство: `~=`).
+
+### GitHub
+
+Направи [GitHub](https://github.com) акаунт.
+
+### PythonAnywhere
+
+Урокът за Django Girls включва раздел за това, което се нарича Прехвърляне, което е процесът на приемане на кода, който захранва новото ви уеб приложение и го премества на обществено достъпен компютър (наречен сървър), за да могат другите хора да виждат работата ви.
+
+Тази част е малко странна, когато правим урока в Chromebook, тъй като вече използваме компютър, който е в Интернет (за разлика от, да речем, лаптоп). Въпреки това, все още е полезно, тъй като можем да мислим за работното пространство на Cloud 9 като място за нашата „текуща“ работа и Python Anywhere като място за показване на нашите неща, когато те станат по-завършени.
+
+По този начин се регистрирайте за нов акаунт в Python Anywhere на адрес [www.pythonanywhere.com](https://www.pythonanywhere.com).

bg/code_editor/README.md

@@ -0,0 +1,11 @@
+# Редактор на код
+
+> За читателите у дома: тази глава е разгледана във видеото [Инсталиране на Python & Редактор на код](https://www.youtube.com/watch?v=pVTaqzKZCdA&t=4m43s).
+
+На път сте да напишете първия си ред код, така че е време да изтеглите редактор на код!
+
+> **Забележка** Ако използвате Chromebook, пропуснете тази глава и се уверете, че следвате инструкциите [Настройка на Chromebook](../chromebook_setup/README.md). Облачният IDE, който сте избрали (PaizaCloud Cloud IDE или AWS Cloud9) включва редактор на код и когато отворите файл във вашия IDE от менюто File, автоматично ще използвате редактора.
+> 
+> ** Забележка ** Може да сте направили това по-рано в главата за инсталиране - ако е така, можете да прескочите веднага до следващата глава!
+
+{% include "/code_editor/instructions.md" %}