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 [email protected]: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 [email protected]: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)

de/chromebook_setup/README.md

@@ -1,5 +1,5 @@
 # Chromebook-Installation
 
-> **Hinweis** Wenn du die Installation bereits gemacht hast, kannst du direkt zur [Einführung in Python](../python_introduction/README.md) gehen.
+> **Hinweis** Wenn du die [Installation bereits gemacht](../installation/README.md) hast, kannst du direkt zur [Einführung in Python](../python_introduction/README.md) gehen.
 
 {% include "/chromebook_setup/instructions.md" %}

de/chromebook_setup/instructions.md

@@ -1,8 +1,8 @@
 Du kannst [diesen Abschnitt einfach](http://tutorial.djangogirls.org/en/installation/#install-python) überspringen, falls du kein Chromebook benutzt. Wenn du eins benutzt, wird deine Installation ein wenig anders sein. Du kannst den Rest der Installationsanweisungen ignorieren.
 
-### Cloud IDE (PaizaCloud Cloud IDE, AWS Cloud9)
+### Cloud-IDE (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com)
 
-Mit dem Tool Cloud IDE erhältst du Zugang zu einem Code-Editor und einem Rechner, der im Internet läuft und auf dem du die Software installieren, schreiben und ausführen kannst. Für die Dauer des Tutorials wird Cloud IDE zu deinem *lokalen Rechner*. Auch du wirst Befehle in einer Kommandozeilen-Oberfläche ausführen können, genau wie die anderen Teilnehmerinnen, die mit OS X, Ubuntu oder Windows arbeiten. Dein Terminal wird jedoch mit einem Rechner verbunden sein, den Cloud IDE dir bereitstellt. Hier ist die Anleitung für die Cloud IDEs (PaizaCloud, Cloud IDE, AWS Cloud9). Wähle eine der Cloud IDEs aus und folge den Anweisungen der gewählten Cloud IDE.
+Eine Cloud-IDE ist ein Werkzeug, dass dir einen Code-Editor und Zugang zu einem Rechner im Internet bereitstellt, auf dem du die Software installieren, anpassen und ausführen kannst. Für die Dauer des Tutorials wird Cloud IDE zu deinem *lokalen Rechner*. Auch du wirst Befehle in einer Kommandozeilen-Oberfläche ausführen können, genau wie die anderen Teilnehmerinnen, die mit OS X, Ubuntu oder Windows arbeiten. Dein Terminal wird jedoch mit einem Rechner verbunden sein, den Cloud IDE dir bereitstellt. Hier sind die Anleitungen für die Cloud-IDEs (PaizaCloud Cloud IDE, AWS Cloud9, Glitch.com). Wähle eine der Cloud-IDEs aus und folge den Anweisungen der gewählten Cloud IDE.
 
 #### PaizaCloud Cloud IDE
 
@@ -43,6 +43,91 @@ Jetzt solltest du eine Benutzeroberfläche mit Seitenleiste, ein grosses Fenster
 
 Dieser untere Bereich ist dein Terminal. Dort kannst du Kommandos für den Computer eingeben, den dir Cloud 9 zur Verfügung stellt. Du kannst dieses Fenster vergrößern oder verkleinern.
 
+#### Glitch.com Cloud-IDE
+
+1. Gehe auf [Glitch.com](https://glitch.com/)
+2. Melde dich für einen Account an (https://glitch.com/signup) oder nutze deinen GitHub-Account, falls du einen hast. (Siehe GitHub-Anweisungen unten.)
+3. Klicke auf *Neues Projekt* und wähle *hello-webpage*
+4. Klicke auf die Dropdown-Liste Tools (unten links im Fenster) und dann auf den Knopf Terminal, um einen Kommandozeilen-Tab mit einem Prompt wie dem folgenden zu öffnen:
+
+{% filename %}Terminal{% endfilename %}
+
+    app@name-deines-glitch-projects:~
+    
+
+Wenn du Glitch.com als Cloud-IDE verwendest, musst du keine virtuelle Umgebung erstellen. Erstelle stattdessen die folgenden Dateien manuell:
+
+{% filename %}glitch.json{% endfilename %}
+
+```json
+{
+  "install": "pip3 install -r requirements.txt --user",
+  "start": "bash start.sh",
+  "watch": {
+    "throttle": 1000
+  }
+}
+```
+
+{% filename %}requirements.txt{% endfilename %}
+
+    Django~={{ book.django_version }}
+    
+
+{% filename %}.bash_profile{% endfilename %}
+
+```bash
+alias python=python3
+alias pip=pip3
+```
+
+{% filename %}start.sh{% endfilename %}
+
+```bash
+chmod 600 .bash_profile
+pip3 install -r requirements.txt --user
+python3 manage.py makemigrations
+python3 manage.py migrate
+python3 manage.py runserver $PORT
+```
+
+Gehe nach dem Erstellen der Dateien zum Terminal und führe die folgenden Befehle aus, um dein erstes Django-Projekt zu erstellen:
+
+{% filename %}Terminal{% endfilename %}
+
+    django-admin.py startproject mysite .
+    refresh
+    
+
+Um detaillierte Fehlermeldungen zu sehen, kannst du Django Debug-Logs für deine Glitch-Anwendung aktivieren. Füge einfach folgendes am Ende der Datei `mysite/settings.py` hinzu.
+
+{% filename %}mysite/settings.py{% endfilename %}
+
+```python
+LOGGING = {
+    'version': 1,
+    'disable_existing_loggers': False,
+    'handlers': {
+        'file': {
+            'level': 'DEBUG',
+            'class': 'logging.FileHandler',
+            'filename': 'debug.log',
+        },
+    },
+    'loggers': {
+        'django': {
+            'handlers': ['file'],
+            'level': 'DEBUG',
+            'propagate': True,
+        },
+    },
+}
+```
+
+Dadurch wird eine Datei namens `debug.log` erzeugt, die aufgetretene Django-Operationen und Fehlermeldungen detailliert aufgeführen wird, was die Fehlersuche und -behebung sehr erleichtern kann, wenn deine Website nicht funktioniert.
+
+Der erste Neustart des Glitch-Projekts sollte fehlschlagen. (Wenn du auf die oberste Dropdown-Schaltfläche `Show` klickst und dann auf `In a New Window`, erhältst du die Fehlermeldung `DisallowedHost`.) Mach dir jetzt keine Sorgen darüber. Das Tutorial wird dies beheben, sobald du die Django-Einstellungen deines Projekts in der Datei `mysite/settings.py` aktualisierst
+
 ### Virtuelle Umgebung
 
 Eine virtuelle Umgebung (auch virtualenv genannt) ist wie ein privater Behälter, in den wir nützlichen Code für ein Projekt packen können, an dem wir arbeiten. Wir benutzen sie, um Code für verschiedene Projekte getrennt aufzubewahren, damit dieser nicht vermischt wird.
@@ -53,7 +138,7 @@ Führe Folgendes aus:
 
     mkdir djangogirls
     cd djangogirls
-    python3.6 -mvenv myvenv
+    python3 -m venv myvenv
     source myvenv/bin/activate
     pip install django~={{ book.django_version }}
 

de/code_editor/README.md

@@ -6,6 +6,6 @@ Gleich geht's los! Du wirst deine erste Zeile Programmcode schreiben! Daher ist
 
 > **Hinweis** Wenn du ein Chromebook benutzt, dann überspringe dieses Kapitel und folge den [Chromebook Installations](../chromebook_setup/README.md)-Anweisungen. Deine Cloud-IDE (PaizaCloud Cloud IDE oder AWS Cloud9) enthält einen Code-Editor und wenn du eine Datei in deiner Entwicklungsumgebung öffnest, wirst du automatisch den Editor benutzen.
 > 
-> **Hinweis:** Es kann sein, dass du diesen Schritt bereits in dem Kapitel "Installation" erledigt hast. In diesem Fall kannst du direkt zum nächsten Kapitel übergehen!
+> **Hinweis:** Es kann sein, dass du diesen Schritt bereits im [Kapitel "Installation"](../installation/README.md) erledigt hast. In diesem Fall kannst du direkt zum nächsten Kapitel übergehen!
 
 {% include "/code_editor/instructions.md" %}

de/code_editor/instructions.md

@@ -14,11 +14,11 @@ Gedit ist ein kostenloser Open-Source-Editor. Es gibt ihn für alle Betriebssyst
 
 [Du kannst ihn hier herunterladen](https://wiki.gnome.org/Apps/Gedit#Download)
 
-## Sublime Text 3
+## Sublime Text
 
 Sublime Text ist ein sehr beliebter Editor, nutzbar für einen kostenlosen Testzeitraum. Er ist einfach zu installieren und zu verwenden, und er ist für alle Betriebssysteme verfügbar.
 
-[Du kannst ihn hier herunterladen](https://www.sublimetext.com/3)
+[Du kannst ihn hier herunterladen](https://www.sublimetext.com/)
 
 ## Atom
 
@@ -34,4 +34,4 @@ Erstens muss Code "plain text" (unformatierter Text) sein. Das Problem mit Progr
 
 Ein weiterer Grund ist, dass Code-Editoren (bisweilen auch Programmier- oder Text-Editoren genannt) auf das Bearbeiten von Programm-Code spezialisiert sind und Funktionen aufweisen, die normale Textverarbeitungen nicht haben. Beispielsweise sogenanntes "Syntax-Highlighting", also farbliches Hervorheben bestimmter Code-Stellen, oder auch das automatische Schließen von Klammern und vieles mehr.
 
-Einiges davon werden wir später in Aktion sehen. Glaub uns: es wird nicht lange dauern, bis du deinen Code-Editor nicht mehr missen möchtest. :)
+Einiges davon werden wir später in Aktion sehen. Glaub uns: es wird nicht lange dauern, bis du deinen Code-Editor nicht mehr missen möchtest. :)