Merge branch 'master' into restructuting-proposal

Author: das-g

README.md

@@ -11,7 +11,7 @@ The Django Girls Tutorial is licensed under a [*Creative Commons Attribution-Sha
 
 The source code of the tutorial is [hosted on GitHub](https://github.com/DjangoGirls/tutorial). The GitHub [Fork & Pull workflow](https://help.github.com/articles/using-pull-requests) is used to accept and review changes.
 
-The tutorial uses the [GitBook](https://legacy.gitbook.com/) service for publishing its documentation. [See more information about how GitBook works](https://help.gitbook.com/).
+The tutorial uses the [HonKit](https://github.com/honkit/honkit) project for publishing its documentation. [See more information about how HonKit works](https://honkit.netlify.app/).
 
 The tutorial is written in [Markdown mark up language](https://help.github.com/articles/markdown-basics).
 
@@ -60,15 +60,24 @@ Either use the GitHub app for your operating system (mentioned above) or `git` c
 
     git clone git@github.com:yourgithubusername/tutorial.git
 
+Move to the folder containing the project, to run the following commands.
+
+    cd tutorial
+
 Then, create a branch for your new changes to sit in. It helps to call the branch something related to the changes you are going to make.
 
     git checkout -b contributing
 
-Download the [GitBook Editor](https://legacy.gitbook.com/editor) app to your computer.
+Install the project's requirements using [`npm`](https://docs.npmjs.com/cli/v8/configuring-npm/install).
+
+    npm install
 
-Then you can open the tutorial in GitBook Editor (*File* > *Open book*).
+To preview and serve local files, with auto-reload capabilities, run HonKit using:
 
-Make any changes in the tutorial using GitBook and then save changes (*Book* > *Save all*).
+    npx honkit serve
+
+The local server will be available at http://localhost:4000.
+If auto-reload is slow, you can temporarily remove unwanted languages from `LANGS.md`, to speed up the process.
 
 Then commit the changes using `git` and push the changes to your remote GitHub repository.
 
@@ -97,8 +106,6 @@ Example:
     To git@github.com:miohtama/tutorial.git
        b37ca59..fe36152  contributing -> contributing
 
-If you don't want to download the GitBook Editor app you can also go to the [GitBook website](https://legacy.gitbook.com/), sign up for free and work directly in your browser.
-
 # Making a pull request
 
 After you have finished your changes you need to create [a pull request](https://help.github.com/articles/using-pull-requests)  on GitHub. DjangoGirls will get notified about the pull request, review your changes, suggest any corrections if needed and then *pull* your changes to the master version.

bg/code_editor/instructions.md

@@ -14,11 +14,11 @@ Gedit е безплатен редактор с отворен код, дост
 
 [Изтеглете го тук](https://wiki.gnome.org/Apps/Gedit#Download)
 
-## Sublime Text 3
+## Sublime Text
 
 Sublime Text е много популярен редактор с безплатен период за ползване и е достъпен за всички операционни системи.
 
-[Изтеглете го тук](https://www.sublimetext.com/3)
+[Изтеглете го тук](https://www.sublimetext.com/)
 
 ## Atom
 
@@ -34,4 +34,4 @@ Atom е друг популярен редактор. Той е безплате
 
 Втората причина е, че редакторите на код са специализирани за редактиране на код, така че те могат да предоставят полезни функции като подчертаване на код с цвят според значението му или автоматично затваряне на кавички.
 
-Ще видим всичко това в действие по-късно. Скоро ще помислите за надеждния си стар редактор на код като за един от любимите си инструменти. :)
+Ще видим всичко това в действие по-късно. Скоро ще помислите за надеждния си стар редактор на код като за един от любимите си инструменти. :)

bg/django_start_project/README.md

@@ -56,7 +56,7 @@
     └── requirements.txt
 
 
-> **Забележка**: в структурата на вашата директория ще видите и вашата `venv` директория, която създадохме преди.
+> **Забележка**: в структурата на вашата директория ще видите и вашата `myvenv` директория, която създадохме преди.
 
 `manage.py` е скрипт, който помага при управлението на сайта. С него ще можем (освен всичко друго) да стартираме уеб сървър на нашия компютър, без да инсталираме нищо друго.
 

bg/installation/README.md

@@ -24,7 +24,8 @@
 
 # Кратко въведение в командния прозорец {#command-line}
 
-Много от стъпките по-долу се позовават на "конзолата", "терминала", "командния прозорец" или "командния ред" - всичко това означава едно и също нещо: прозорец на вашия компютър, в който можете да въведете команди. Когато стигнете до главния урок, ще научите повече за командния ред. Засега основното, което трябва да знаете, е как да отворите команден прозорец и как изглежда: {% include "/intro_to_command_line/open_instructions.md" %}
+Много от стъпките по-долу се позовават на "конзолата", "терминала", "командния прозорец" или "командния ред" - всичко това означава едно и също нещо: прозорец на вашия компютър, в който можете да въведете команди. Когато стигнете до главния урок, ще научите повече за командния ред. Засега основното, което трябва да знаете, е как да отворите команден прозорец и как изглежда:
+{% include "/intro_to_command_line/open_instructions.md" %}
 
 # Инсталиране на Python {#python}
 
@@ -64,4 +65,4 @@
 
 # Насладете се на уъркшопа!
 
-Когато започнете семинара, ще можете да преминете направо към [първия си проект на Django!](../django_start_project/README.md), защото вече сте обхванали материала в по-ранните глави.
+Когато започнете семинара, ще можете да преминете направо към [първия си проект на Django!](../django_start_project/README.md), защото вече сте обхванали материала в по-ранните глави.

bg/intro_to_command_line/open_instructions.md

@@ -1,3 +1,4 @@
+
 <!--sec data-title="Opening: Windows" data-id="windows_prompt" data-collapse=true ces-->
 
 В зависимост от вашата версия на Windows и клавиатурата ви, едно от следните трябва да отвори команден прозорец (може да се наложи да експериментирате малко, но не е нужно да изпробвате всички тези предложения):
@@ -25,4 +26,4 @@
 
 Вероятно е под Applications → Accessories → Terminal или Applications → System → Terminal, но това може да зависи от вашата система. Ако не е там, можете да опитате да го потърсите в Google. :)
 
-<!--endsec-->
+<!--endsec-->

book.json

@@ -6,7 +6,7 @@
       "py_min_version": "3.6",
       "py_min_release": "3.6.8",
       "pa_py_version": "3.8",
-      "django_version": "2.2.4"
+      "django_version": "3.2.10"
     },
     "links": {
         "sidebar": {

cs/code_editor/instructions.md

@@ -8,11 +8,11 @@ Gedit je open-source editor. Je k dispozici zdarma pro všechny operační syst
 
 [Stáhnout si jej můžeš zde](https://wiki.gnome.org/Apps/Gedit#Download)
 
-## Sublime Text 3
+## Sublime Text
 
 Sublime Text je velmi oblíbený editor s bezplatnou zkušební dobou. Lze jej snadno nainstalovat a používat. Je k dispozici pro všechny operační systémy.
 
-[Stáhnout si jej můžeš zde](https://www.sublimetext.com/3)
+[Stáhnout si jej můžeš zde](https://www.sublimetext.com/)
 
 ## Atom
 
@@ -28,4 +28,4 @@ První důvod je, že kód musí být **prostý text** a programy jako Word a Te
 
 Druhým důvodem je, že editory kódu se specializují na editaci kódu, takže mohou poskytovat užitečné funkce, jako je barevné zvýraznění kódu podle jeho významu nebo automatické ukončování uvozovek apod.
 
-Vše to uvidíme v akci později. Brzy ti přijde tvůj oblíbený editor kódu jako jeden z tvých nejlepších nástrojů :)
+Vše to uvidíme v akci později. Brzy ti přijde tvůj oblíbený editor kódu jako jeden z tvých nejlepších nástrojů :)

cs/django_models/README.md

@@ -110,12 +110,13 @@ V souboru `blog/models.py` budeme definovat všechny objekty nazývané `modely`
 Otevři `blog/models.py`, odstraň vše, co v něm je, a vlož následující kód:
 
 ```python
+from django.conf import settings
 from django.db import models
 from django.utils import timezone
 
 
 class Post(models.Model):
-    author = models.ForeignKey('auth.User', on_delete=models.CASCADE)
+    author = models.ForeignKey(settings.AUTH_USER_MODEL, on_delete=models.CASCADE)
     title = models.CharField(max_length=200)
     text = models.TextField()
     created_date = models.DateTimeField(

de/README.md

@@ -6,9 +6,9 @@
 
 ## Willkommen
 
-Willkommen beim Django Girls Tutorial! Wir freuen uns, dass du hier bist :) In diesem Tutorial schauen wir gemeinsam unter die Haube der Technologien im Internet, geben dir einen Einblick in die Bits und Bytes, die zusammen das Internet bilden, wie wir es heute kennen.
+Willkommen beim Django Girls Tutorial! Wir freuen uns, dass du hier bist. :) In diesem Tutorial schauen wir gemeinsam unter die Haube der Technologien im Internet, geben dir einen Einblick in die Bits und Bytes, die zusammen das Internet bilden, wie wir es heute kennen.
 
-Wie alles Unbekannte wird das ein Abenteuer sein - aber keine Sorge: Da du bereits den Mut aufgebracht hast, hier zu sein, wirst du das schon meistern :)
+Wie alles Unbekannte wird das ein Abenteuer sein – aber keine Sorge: Da du bereits den Mut aufgebracht hast, hier zu sein, wirst du das schon meistern. :)
 
 ## Einleitung
 

de/SUMMARY.md

@@ -8,8 +8,8 @@
   * [Virtuelle Umgebung](installation/README.md#virtualenv)
   * [Django](installation/README.md#django)
   * [Git](installation/README.md#git)
-  * [GitHub](installation/README.md#github)
-  * [PythonAnywhere](installation/README.md#pythonanywhere)
+  * [GitHub](installation/README.md#github-account)
+  * [PythonAnywhere](installation/README.md#pythonanywhere-account)
 * [Installation (Chromebook)](chromebook_setup/README.md)
 * [Wie das Internet funktioniert](how_the_internet_works/README.md)
 * [Einführung in die Kommandozeile](intro_to_command_line/README.md)